UcmTcpciPortControllerSetHardwareRequestQueue-Funktion (ucmtcpciportcontroller.h)

  • Artikel

Weist ein Frameworkwarteschlangenobjekt zu, dem ucmTcpciCx Hardwareanforderungen für den Portcontroller sendet.

Syntax

void UcmTcpciPortControllerSetHardwareRequestQueue(
  UCMTCPCIPORTCONTROLLER PortControllerObject,
  WDFQUEUE               HardwareRequestQueue
);

Parameter

PortControllerObject

Handle mit dem Portcontrollerobjekt, das der Clienttreiber beim vorherigen Aufruf von UcmTcpciPortControllerCreate empfangen hat.

HardwareRequestQueue

Ein Handle für das zuzuweisende Framework-Warteschlangenobjekt.

Rückgabewert

Keine

Bemerkungen

Der Clienttreiber muss UcmTcpciPortControllerSetHardwareRequestQueue aufrufen, nachdem das Portcontrollerobjekt erstellt wurde. Der Treiber muss diese Methode nur einmal aufrufen, bevor UcmTcpciPortControllerStart aufgerufen wird.

Das übergeordnete Element des Warteschlangenobjekts ist das Portcontrollerobjekt.

Ein Clienttreiber kann dieselbe Warteschlange für mehrere Portcontrollerobjekte verwenden. In diesem Fall muss der Treiber jedoch sicherstellen, dass die Portcontrollerobjekte das Warteschlangenobjekt nicht überdauern. Das Warteschlangenobjekt darf erst gelöscht werden, nachdem alle Portcontroller beendet wurden. UcmTcpciCx garantiert, dass pro Portcontrollerobjekt jeweils nur eine Anforderung in der Warteschlange verarbeitet wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
Kopfzeile ucmtcpciportcontroller.h
IRQL <=DISPATCH_LEVEL

Weitere Informationen

UcmTcpciPortControllerCreate