UcmTcpciPortControllerSetHardwareRequestQueue, fonction (ucmtcpciportcontroller.h)

  • Article

Affecte un objet de file d’attente d’infrastructure auquel UcmTcpciCx distribue les demandes matérielles pour le contrôleur de port.

Syntaxe

void UcmTcpciPortControllerSetHardwareRequestQueue(
  UCMTCPCIPORTCONTROLLER PortControllerObject,
  WDFQUEUE               HardwareRequestQueue
);

Paramètres

PortControllerObject

Gérez l’objet du contrôleur de port que le pilote client a reçu lors de l’appel précédent à UcmTcpciPortControllerCreate.

HardwareRequestQueue

Handle à l’objet de file d’attente d’infrastructure à affecter.

Valeur de retour

None

Remarques

Le pilote client doit appeler UcmTcpciPortControllerSetHardwareRequestQueue après avoir créé l’objet contrôleur de port. Le pilote ne doit appeler cette méthode qu’une seule fois avant d’appeler UcmTcpciPortControllerStart.

Le parent de l’objet file d’attente est l’objet du contrôleur de port.

Un pilote client peut choisir d’utiliser la même file d’attente sur plusieurs objets de contrôleur de port. Toutefois, dans ce cas, le pilote doit s’assurer que les objets du contrôleur de port ne survivent pas à l’objet file d’attente. L’objet file d’attente doit être supprimé uniquement une fois que tous les contrôleurs de port ont été arrêtés. UcmTcpciCx garantit qu’une seule requête est traitée dans la file d’attente à la fois par objet contrôleur de port.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
En-tête ucmtcpciportcontroller.h
IRQL <=DISPATCH_LEVEL

Voir aussi

UcmTcpciPortControllerCreate