EVT_UCX_CONTROLLER_RESET コールバック関数 (ucxcontroller.h)

UCX がコントローラーをリセットするために呼び出すクライアント ドライバーの実装。

構文

EVT_UCX_CONTROLLER_RESET EvtUcxControllerReset;

void EvtUcxControllerReset(
  [in] UCXCONTROLLER UcxController
)
{...}

パラメーター

[in] UcxController

UcxControllerCreate メソッドの以前の呼び出しでクライアント ドライバーが受信した UCX コントローラーへのハンドル。

戻り値

何一つ

備考

UCX クライアント ドライバーは、UcxControllerCreate メソッドを呼び出すことによって、その EVT_UCX_CONTROLLER_RESET 実装を USB ホスト コントローラー拡張機能 (UCX) に登録します。

クライアント ドライバーは、UcxControllerResetComplete メソッドを呼び出すことによって、このイベントの完了を示します。 これにより、UCX は、このイベント コールバックが完了する前に 2 回目 EVT_UCX_CONTROLLER_RESET 呼び出されないようにします。

クライアント ドライバーが UcxControllerNeedsReset 呼び出す場合、UCX はこのイベント コールバック関数を呼び出します。 ただし、UCX は、クライアント ドライバーが UcxControllerNeedsReset 呼び出していない場合でも、このイベント コールバック関数を呼び出すことができます。

例

VOID
Controller_EvtControllerReset(
    UCXCONTROLLER UcxController
)

{
    UCX_CONTROLLER_RESET_COMPLETE_INFO controllerResetCompleteInfo;

    //
    // TODO: Reset the controller
    //

    //
    // TODO: Were devices and endpoints programmed in the controller before the reset
    // still programmed in the controller after the reset?
    //
    UCX_CONTROLLER_RESET_COMPLETE_INFO_INIT(&controllerResetCompleteInfo,
                                            UcxControllerStateLost,
                                            TRUE); // reset due to UCX, received EvtReset after WDF power-up

    DbgTrace(TL_INFO, Controller, "Controller_EvtControllerReset");

    UcxControllerResetComplete(UcxController, &controllerResetCompleteInfo);
}

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
最小 KMDF バージョン	1.0
UMDF の最小バージョン を する	2.0
ヘッダー	ucxcontroller.h (Ucxclass.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

UcxControllerCreate の

UcxControllerNeedsReset の

UcxControllerResetComplete の