通过

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