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 の