UsbPm_RetrieveConnectorState 函数 (usbpmapi.h)

检索连接器的当前状态。 与连接器属性不同,状态信息是动态的,可以在运行时更改。

语法

NTSTATUS UsbPm_RetrieveConnectorState(
  [In]  USBPM_CLIENT           ClientHandle,
  [In]  USBPM_CONNECTOR        ConnectorHandle,
  [Out] PUSBPM_CONNECTOR_STATE ConnectorState
);

参数

[In] ClientHandle

客户端驱动程序在对 UsbPm_Register 的上一次调用中收到的句柄。

[In] ConnectorHandle

策略管理器在调用驱动程序实现 EVT_USBPM_EVENT_CALLBACK时提供的连接器句柄。 句柄在 Params 值的 EventData.ConnectorStateChange.ConnectorHandle 成员中设置。

[Out] ConnectorState

指向驱动程序提供的 USBPM_CONNECTOR_STATE 结构的指针,该结构接收连接器状态。 通过调用 USBPM_CONNECTOR_STATE_INIT 初始化 结构。

返回值

如果操作成功,则返回STATUS_SUCCESS。 否则,返回相应的 NTSTATUS 值。

要求

要求
最低受支持的客户端 Windows 10 版本 1809
最低 KMDF 版本 1.27
最低 UMDF 版本 2.27
标头 usbpmapi.h
Library UsbPmApi.lib
IRQL PASSIVE_LEVEL

另请参阅

UsbPm_Register

EVT_USBPM_EVENT_CALLBACK