接口实现指南

本部分提供有关接口实现的指导。

在本节

主题 DESCRIPTION

可用的接口和相关 API

有三个 GPIO 接口:一个用于每个设备。 每个接口由 GUID 引用。

指示器实现

本主题介绍指示器实现。

按钮实现

建议对按钮和状态指示器使用物理 GPIO 资源。

系统状态

加载时收件箱驱动程序支持的所有按钮的默认状态为 UP 位置。

使用接口将指定按钮(按索引)切换为 DOWN 状态的第一个指示。

笔记本/平板模式指示器的默认状态为 SLATE。

停靠模式指示器的默认状态为 UNDOCKED。

使用接口的首次指示将指示器切换到另一种状态。

若要查询状态,可以使用 GetSystemMetric API,如下所示:

int WINAPI GetSystemMetrics(
  _In_  int nIndex
);

可用于指示器的参数:

  • SM_SYSTEMDOCKED用于对接状态。 对于未停靠模式,函数调用返回 0,否则返回非零值。
  • SM_CONVERTIBLESLATEMODE平板模式。 对于 Slate Mode,调用返回 0,否则返回非零。

通知

当系统指标SM_CONVERTIBLESLATEMODE或SM_SYSTEMDOCKED更改时,系统会使用WM_SETTINGCHANGE发送广播消息。

WM_SETTINGCHANGE消息的 LPARAM 通过使用字符串“ConvertibleSlateMode”或“SystemDockMode”来指示哪些系统指标发生了更改。