EVT_UCX_USBDEVICE_HUB_INFO コールバック関数 (ucxusbdevice.h)
UCX がハブ プロパティを取得するために呼び出すクライアント ドライバーの実装。
構文
EVT_UCX_USBDEVICE_HUB_INFO EvtUcxUsbdeviceHubInfo;
void EvtUcxUsbdeviceHubInfo(
[in] UCXCONTROLLER UcxController,
[in] WDFREQUEST Request
)
{...}
パラメーター
[in] UcxController
UcxControllerCreate メソッドの以前の呼び出しでクライアント ドライバーが受信した UCX コントローラーへのハンドル。
[in] Request
USBDEVICE_HUB_INFO構造体を格納します。
戻り値
なし
解説
UCX クライアント ドライバーは、 UcxUsbDeviceCreate メソッドを呼び出すことによって、USB ホスト コントローラー拡張機能 (UCX) にこのコールバック関数を登録します。
USB デバイスがハブでない場合は、このコールバックを指定しないでください。
クライアント ドライバーは 、要求で完了状態を返します。 ドライバーは、WDFREQUEST を非同期的に完了できます。
例
VOID
UsbDevice_EvtUcxUsbDeviceHubInfo(
UCXCONTROLLER UcxController,
WDFREQUEST Request
)
{
UNREFERENCED_PARAMETER(UcxController);
DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceHubInfo");
//
// Retrieve the USBDEVICE_HUB_INFO pointer from the
// IOCTL_INTERNAL_USB_USBDEVICE_HUB_INFO WdfRequest.
//
WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
hubInfo = (PUSBDEVICE_HUB_INFO)wdfRequestParams.Parameters.Others.Arg1;
....
WdfRequestComplete(Request, STATUS_SUCCESS);
}
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | ucxusbdevice.h (Ucxclass.h を含む) |
| IRQL | DISPATCH_LEVEL |