EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER funzione di callback (ucxcontroller.h)

Articolo
02/26/2024

Implementazione del driver client che UCX chiama per recuperare il numero di frame a 32 bit corrente.

Sintassi

EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER EvtUcxControllerGetCurrentFramenumber;

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

Parametri

[in] UcxController

Handle al controller UCX ricevuto dal driver client in una chiamata precedente al metodo UcxControllerCreate .

[out] FrameNumber

Puntatore al numero di fotogramma a 32 bit corrente.

Valore restituito

Se l'operazione ha esito positivo, la funzione di callback deve restituire STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(stato) equivale a TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(stato) equivale a FALSE.

Commenti

Il driver client UCX registra la sua implementazione EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER con l'estensione del controller host USB (UCX) chiamando il metodo UcxControllerCreate .

Esempio

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Versione KMDF minima	1,0
Versione UMDF minima	2,0
Intestazione	ucxcontroller.h (includere Ucxclass.h)
IRQL	PASSIVE_LEVEL

Vedi anche

UcxControllerCreate

Condividi tramite