EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER fonction de rappel (ucxcontroller.h)

Article
02/07/2025

Implémentation du pilote client qui appelle UCX pour récupérer le numéro d’image 32 bits actuel.

Syntaxe

EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER EvtUcxControllerGetCurrentFramenumber;

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

Paramètres

[in] UcxController

Handle du contrôleur UCX reçu par le pilote client lors d’un appel précédent à la méthode UcxControllerCreate.

[out] FrameNumber

Pointeur vers le numéro d’image 32 bits actuel.

Valeur de retour

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS, ou une autre valeur d’état pour laquelle NT_SUCCESS(status) a la valeur TRUE. Sinon, il doit retourner une valeur d’état pour laquelle NT_SUCCESS(status) a la valeur FALSE.

Remarques

Le pilote client UCX inscrit son implémentation EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER auprès de l’extension ucX (Host Controller Extension) USB en appelant la méthode UcxControllerCreate.

Exemples

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

Exigences

Exigence	Valeur
plateforme cible	Windows
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	ucxcontroller.h (include Ucxclass.h)
IRQL	PASSIVE_LEVEL

Voir aussi

ucxControllerCreate

Partager via