共用方式為

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 方法，向 USB 主機控制器擴充功能 （UCX） 註冊其 EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER 實作。

例子

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 （include Ucxclass.h）
IRQL PASSIVE_LEVEL

另請參閱

UcxControllerCreate