EVT_UCX_ROOTHUB_INTERRUPT_TX fonction de rappel (ucxroothub.h)

Article
02/07/2025

Implémentation du pilote client que UCX appelle lorsqu’il reçoit une demande d’informations sur les ports modifiés.

Syntaxe

EVT_UCX_ROOTHUB_INTERRUPT_TX EvtUcxRoothubInterruptTx;

void EvtUcxRoothubInterruptTx(
  [in] UCXROOTHUB UcxRootHub,
  [in] WDFREQUEST Request
)
{...}

Paramètres

[in] UcxRootHub

Handle vers un objet UCX qui représente le hub racine.

[in] Request

Contient le URB pour la demande de transfert d’interruption du hub racine.

Valeur de retour

Aucun

Remarques

Le pilote client UCX inscrit cette fonction de rappel auprès de l’extension UCX (Host Controller Extension) USB en appelant la méthode UcxRootHubCreate.

Le paramètre Requête contient une mémoire tampon dans laquelle chaque bit correspond à un port de hub racine, avec le premier bit correspondant au premier port. Le pilote client définit le bit correspondant si un port a changé, puis termine la requête.

Le pilote client retourne l’état d’achèvement dans demande.

Exemples

Cet extrait de code montre comment le rappel extrait la demande de transfert d’interruption du hub racine.

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

        urb = (PURB)wdfRequestParams.Parameters.Others.Arg1;
        transferBuffer = urb->UrbBulkOrInterruptTransfer.TransferBuffer;
        transferBufferLength = urb->UrbBulkOrInterruptTransfer.TransferBufferLength;

Exigences

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

Partager via