UcmTcpciPortControllerSetHardwareRequestQueue-Funktion (ucmtcpciportcontroller.h)
Weist ein Framework-Warteschlangenobjekt zu, an das der UcmTcpciCx Hardwareanforderungen für den Portcontroller verteilt.
Syntax
void UcmTcpciPortControllerSetHardwareRequestQueue(
UCMTCPCIPORTCONTROLLER PortControllerObject,
WDFQUEUE HardwareRequestQueue
);
Parameter
PortControllerObject
Handle to the port controller object that the client driver received in the previous call to UcmTcpciPortControllerCreate.
HardwareRequestQueue
Ein Handle zum Zuweisen des Framework-Warteschlangenobjekts.
Rückgabewert
Nichts
Bemerkungen
Der Clienttreiber muss UcmTcpciPortControllerSetHardwareRequestQueue aufrufen, nachdem das Portcontrollerobjekt erstellt wurde. Der Treiber muss diese Methode nur einmal aufrufen, bevor UcmTcpciPortControllerStartaufgerufen wird.
Das übergeordnete Objekt des Warteschlangenobjekts ist das Portcontrollerobjekt.
Ein Clienttreiber kann die gleiche Warteschlange für mehrere Portcontrollerobjekte verwenden. In diesem Fall muss der Treiber jedoch sicherstellen, dass die Portcontrollerobjekte das Warteschlangenobjekt nicht überstehen. Das Warteschlangenobjekt muss 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 |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Fenster |
| Header- | ucmtcpciportcontroller.h |
| IRQL- | <=DISPATCH_LEVEL |