UcmTcpciPortControllerSetHardwareRequestQueue-Funktion (ucmtcpciportcontroller.h)
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 |