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 で登録を解除します。