关于示例和工具

Windows SDK 包含有用的代码示例和工具,可帮助你了解和使用 Windows 传感器和位置平台和相关 API。

示例

Windows SDK 包括以下传感器 API 示例。 可以在安装了 Windows SDK 的 \Samples\winui\Sensors 文件夹中找到传感器 API 示例。 例如,如果在驱动器 C 上安装 Windows SDK,则会在以下文件夹中找到示例:C:\Program Files\Microsoft SDKs\Windows\v7.0\Samples\winui\Sensors。

示例名称 描述
AmbientLightAware 此 MFC 示例演示如何通过从计算机上的环境光传感器读取数据并根据照明条件更改文本大小来使用传感器 API。 可以看到显示如何管理事件以及如何请求用户权限的代码。 还可以查看如何根据不同的照明条件管理用户界面的示例。 有关详细信息,请参阅 创建Light-Aware用户界面
必须安装 Visual Studio 2008 才能生成此示例。

有关详细信息,请参阅示例随附的名为 ReadMe.txt 的文件。

还可以从代码库下载 AmbientLightAware 示例。 有关详细信息,请参阅 环境光感知 下载页。

工具

Windows SDK 包含一个虚拟光传感器,可用于模拟基于硬件的光传感器设备。 可以使用此工具向 AmbientLightAware 示例提供数据,以查看示例中的代码的工作原理。

下表描述了运行虚拟光传感器时必须使用的文件。 可以在安装 Windows SDK 的名为 Bin 的文件夹中找到这些文件。 例如,如果在 32 位计算机上的驱动器 C 上安装 Windows SDK,则会在以下文件夹中找到虚拟光传感器文件:C:\Program Files\Microsoft SDKs\Windows\v7.0\Bin。 在 64 位计算机上,必须使用 64 位版本的工具。 在 Windows SDK 中,64 位工具位于名为 x64 的子文件夹中。

文件名 说明
VirtualLightSensor.exe 此程序提供了一个滑块控件,使你能够更改虚拟传感器报告的光数据的级别。
VirtualLightSensorDriver.dll 模拟光传感器的逻辑传感器驱动程序。
VirtualLightSensorDriver.inf 虚拟光传感器驱动程序的 INF 文件。

安装虚拟光传感器

在使用虚拟光传感器应用程序之前,必须安装逻辑传感器驱动程序。 执行以下步骤:

  1. 以管理员身份打开命令窗口。
  2. 更改为 Windows SDK Bin 文件夹。
  3. 键入 pnputil -a VirtualLightSensorDriver.inf
  4. 出现提示时,单击“ 仍然安装此驱动程序软件”。
  5. 等待命令窗口报告已成功安装驱动程序。

运行虚拟光传感器

若要运行虚拟光传感器,只需双击.exe文件。 请务必在出现提示时启用传感器。

运行程序时,你可能会注意到传感器可用之前存在延迟。 当逻辑传感器管理器为逻辑传感器创建设备节点时,虚拟光传感器用户界面将在标题栏中显示“正在等待”消息。 等待消息消失后,可以使用滑块设置虚拟光传感器的照度输出级别。

下图显示了处于就绪状态的虚拟光传感器用户界面。

虚拟光传感器用户界面

关于逻辑传感器

SENSOR_CATEGORY_LIGHT