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

UCX が現在の 32 ビット フレーム番号を取得するために呼び出すクライアント ドライバーの実装。

構文

EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER EvtUcxControllerGetCurrentFramenumber;

NTSTATUS EvtUcxControllerGetCurrentFramenumber(
  [in]  UCXCONTROLLER UcxController,
  [out] PULONG FrameNumber
)
{...}

パラメーター

[in] UcxController

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

[out] FrameNumber

現在の 32 ビット フレーム番号へのポインター。

戻り値

操作が成功した場合、コールバック関数はSTATUS_SUCCESSを返すか、NT_SUCCESS(status) が TRUE の別の状態値を返す必要があります。 それ以外の場合は、NT_SUCCESS(status) が FALSE の状態値を返す必要があります。

備考

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

例

NTSTATUS
Controller_EvtControllerGetCurrentFrameNumber(
    UCXCONTROLLER   UcxController,
    PULONG          FrameNumber
)

{
    UNREFERENCED_PARAMETER(UcxController);

    //
    // TODO: Return the current 32-bit frame number.  Do not access the
    // controller registers if the controller is not in D0.
    //

    *FrameNumber = 0xFFFFFFFF;

    DbgTrace(TL_INFO, Controller, "Controller_EvtControllerGetCurrentFrameNumber");

    return STATUS_SUCCESS;
}

必要条件

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

関連項目

UcxControllerCreate の