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 |