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

こちらもご覧ください

ENDPOINTS_CONFIGURE

UcxUsbDeviceCreate