EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER funzione di callback (ucxcontroller.h)

Articolo
02/07/2025

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 per il controller UCX ricevuto dal driver client in una chiamata precedente al metodo UcxControllerCreate.

[out] FrameNumber

Puntatore al numero di frame 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(status) è TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(status) è uguale a FALSE.

Osservazioni

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

Esempi

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	ucxcontroller.h (include Ucxclass.h)
IRQL	PASSIVE_LEVEL

Vedere anche

UcxControllerCreare

Condividi tramite