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 (状态) 等于 TRUE 的另一个状态值。 否则,它必须返回NT_SUCCESS (状态) 等于 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;
}
要求
要求 | 值 |
---|---|
目标平台 | Windows |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | ucxcontroller.h (包括 Ucxclass.h) |
IRQL | PASSIVE_LEVEL |