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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die ConfigureRequestDispatching--Methode konfiguriert die Warteschlange 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-typed-Wert, der den Anforderungstyp identifiziert, der in die Warteschlange gestellt werden soll. Die einzigen gültigen Werte sind WdfRequestCreate, WdfRequestRead, WdfRequestWriteund WdfRequestDeviceIoControl.
[in] Forward
Ein BOOL-Wert, der angibt, ob Anforderungen des angegebenen Typs in die Warteschlange gestellt werden. TRUE gibt an, dass Warteschlangenanforderungen aktiviert werden; FALSE- gibt an, dass Warteschlangenanforderungen deaktiviert werden.
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.
Bemerkungen
Der Treiber kann die ConfigureRequestDispatching Methode mehrmals aufrufen, um zu konfigurieren, wie jeder Anforderungstyp an die E/A-Warteschlange verteilt wird.
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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |