EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE コールバック関数 (ucxusbdevice.h)
UCX がコントローラーでエンドポイントを構成するために呼び出すクライアント ドライバーの実装。
構文
EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE EvtUcxUsbdeviceEndpointsConfigure;
void EvtUcxUsbdeviceEndpointsConfigure(
[in] UCXCONTROLLER UcxController,
[in] WDFREQUEST Request
)
{...}
パラメーター
[in] UcxController
UcxControllerCreate メソッドの以前の呼び出しでクライアント ドライバーが受信した UCX コントローラーへのハンドル。
[in] Request
構造体型の構造体 ENDPOINTS_CONFIGURE 格納します。
戻り値
なし
解説
UCX クライアント ドライバーは、 UcxUsbDeviceCreate メソッドを呼び出すことによって、USB ホスト コントローラー拡張機能 (UCX) にこのコールバック関数を登録します。
コールバックでは、ドライバーは、 ENDPOINTS_CONFIGURE 構造体で説明されているように、エンドポイントをプログラムまたはデプログラミングします。
このコールバックは、既定のエンドポイントを有効または無効にしません。 既定のエンドポイントの状態は、デバイスの状態に関連付けられています。 ドライバーは、 EVT_UCX_USBDEVICE_DISABLEおよびEVT_UCX_USBDEVICE_ENABLE コールバック関数の有効化および無効化操作 を 実装します。
クライアント ドライバーは 、要求で完了状態を返します。 ドライバーは、WDFREQUEST を非同期的に完了できます。
例
VOID
UsbDevice_EvtUcxUsbDeviceEndpointsConfigure(
UCXCONTROLLER UcxController,
WDFREQUEST Request
)
{
UNREFERENCED_PARAMETER(UcxController);
DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceEndpointsConfigure");
WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
...
endpointsConfigure = (PENDPOINTS_CONFIGURE)wdfRequestParams.Parameters.Others.Arg1;
...
WdfRequestComplete(Request, STATUS_SUCCESS);
}
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | ucxusbdevice.h (Ucxclass.h を含む) |
| IRQL | DISPATCH_LEVEL |