IWDFIoQueue::ConfigureRequestDispatching-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]
Die ConfigureRequestDispatching-Methode konfiguriert die Warteschlangen von E/A-Anforderungen des angegebenen Typs.
Syntax
HRESULT ConfigureRequestDispatching(
[in] WDF_REQUEST_TYPE RequestType,
[in] BOOL Forward
);
Parameter
[in] RequestType
Ein WDF_REQUEST_TYPE typisierter Wert, der den Anforderungstyp identifiziert, der in die Warteschlange eingereiht werden soll. Die einzigen gültigen Werte sind WdfRequestCreate, WdfRequestRead, WdfRequestWrite und WdfRequestDeviceIoControl.
[in] Forward
Ein BOOL-Wert, der angibt, ob Anforderungen des angegebenen Typs in eine Warteschlange gestellt werden. TRUE gibt an, Warteschlangenanforderungen zu aktivieren. FALSE gibt an, Warteschlangenanforderungen zu deaktivieren.
Rückgabewert
ConfigureRequestDispatching gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.
Hinweise
Der Treiber kann die ConfigureRequestDispatching-Methode mehrmals aufrufen, um zu konfigurieren, wie die einzelnen Anforderungstypen an die E/A-Warteschlange verteilt werden.
Beispiele
Das folgende Codebeispiel zeigt, wie Die Weiterleitung für IOCTL-Anforderungen konfiguriert wird.
//
// Configure forwarding for IOCTL requests
//
HRESULT hr = m_FxQueue->ConfigureRequestDispatching(
WdfRequestDeviceIoControl,
true
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |