UsbPm_Register 函数 (usbpmapi.h)

向策略管理器注册客户端驱动程序,以报告中心到达/删除和连接器状态更改。

语法

NTSTATUS UsbPm_Register(
  [In]  PUSBPM_CLIENT_CONFIG ClientConfig,
  [Out] USBPM_CLIENT         *ClientHandle
);

参数

[In] ClientConfig

指向调用方提供的 USBPM_CLIENT_CONFIG 结构的指针。 通过调用宏 USBPM_CLIENT_CONFIG_INIT初始化结构。

[Out] ClientHandle

指向接收注册操作句柄的位置的指针。

返回值

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

注解

UsbPm_Register 返回之前,客户端驱动程序的回调函数可能会开始调用。 在调用回调函数之前, ClientHandle 值设置为有效值。

驱动程序通常调用驱动程序EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT中的UsbPm_Register并通过调用UsbPm_Deregister 在 EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP 中注销。

要求

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