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中取消註冊。