функция обратного вызова 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

Дескриптор контроллера UCX, который драйвер клиента получил в предыдущем вызове метода UcxControllerCreate .

[out] FrameNumber

Указатель на текущий 32-разрядный номер кадра.

Возвращаемое значение

Если операция выполнена успешно, функция обратного вызова должна возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(status) равно TRUE. В противном случае он должен возвращать значение состояния, для которого NT_SUCCESS(status) равно FALSE.

Комментарии

Драйвер клиента UCX регистрирует свою реализацию EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER с расширением USB-контроллера узла (UCX), вызывая метод UcxControllerCreate .

Примеры

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

См. также раздел

UcxControllerCreate