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