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 Version 1809
最小 KMDF バージョン 1.27
最小 UMDF バージョン 2.27
Header usbpmapi.h
Library UsbPmApi.lib
IRQL PASSIVE_LEVEL