Compartir a través de


EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER función de devolución de llamada (ucxcontroller.h)

La implementación del controlador cliente que UCX llama para recuperar el número de fotograma de 32 bits actual.

Sintaxis

EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER EvtUcxControllerGetCurrentFramenumber;

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

Parámetros

[in] UcxController

Identificador del controlador UCX que el controlador cliente recibió en una llamada anterior al método ucxControllerCreate .

[out] FrameNumber

Puntero al número de fotograma de 32 bits actual.

Valor devuelto

Si la operación se realiza correctamente, la función de devolución de llamada debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.

Observaciones

El controlador cliente UCX registra su implementación de EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER con la extensión del controlador de host USB (UCX) llamando al método UcxControllerCreate.

Ejemplos

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;
}

Requisitos

Requisito Valor
de la plataforma de destino de Windows
versión mínima de KMDF 1.0
versión mínima de UMDF 2.0
encabezado de ucxcontroller.h (incluya Ucxclass.h)
irQL PASSIVE_LEVEL

Consulte también

UcxControllerCreate