EVT_UCX_DEFAULT_ENDPOINT_UPDATE fonction de rappel (ucxendpoint.h)

Article
02/07/2025

Implémentation du pilote client qui appelle UCX avec des informations sur le point de terminaison par défaut.

Syntaxe

EVT_UCX_DEFAULT_ENDPOINT_UPDATE EvtUcxDefaultEndpointUpdate;

void EvtUcxDefaultEndpointUpdate(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

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.

[in] Request

Structure DEFAULT_ENDPOINT_UPDATE qui contient le handle vers le point de terminaison par défaut à mettre à jour.

Valeur de retour

Aucun

Remarques

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

UCX appelle généralement cette routine pour mettre à jour la taille maximale du paquet du point de terminaison par défaut. Le pilote client retourne l’état d’achèvement dans WDFREQUEST, qu’il peut terminer de manière asynchrone.

Exemples

VOID
Endpoint_EvtUcxDefaultEndpointUpdate(
    UCXCONTROLLER   UcxController,
    WDFREQUEST      Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, Endpoint, "Endpoint_EvtUcxDefaultEndpointUpdate");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);

    defaultEndpointUpdate = (PDEFAULT_ENDPOINT_UPDATE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

Exigences

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

Voir aussi

UCX_DEFAULT_ENDPOINT_EVENT_CALLBACKS_INIT

UcxDefaultEndpointInitSetEventCallbacks

Partager via