Compartilhar via

EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER função de retorno de chamada (ucxcontroller.h)

  • Artigo

A implementação do driver cliente que o UCX chama para recuperar o número de quadro atual de 32 bits.

Sintaxe

EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER EvtUcxControllerGetCurrentFramenumber;

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

Parâmetros

[in] UcxController

Um identificador para o controlador UCX que o driver cliente recebeu em uma chamada anterior para o método UcxControllerCreate .

[out] FrameNumber

Um ponteiro para o número de quadro atual de 32 bits.

Retornar valor

Se a operação for bem-sucedida, a função de retorno de chamada deverá retornar STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE.

Comentários

O driver cliente UCX registra sua implementação de EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER com a UCX (extensão do controlador de host USB) chamando o método UcxControllerCreate .

Exemplos

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
Plataforma de Destino Windows
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho ucxcontroller.h (inclua Ucxclass.h)
IRQL PASSIVE_LEVEL

Confira também

UcxControllerCreate