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，並在 EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP 中取消註冊，方法是呼叫 UsbPm_Deregister。