[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]
The ConfigureRequestDispatching method configures the queuing of I/O requests of the given type.
HRESULT ConfigureRequestDispatching( WDF_REQUEST_TYPE RequestType, BOOL Forward );
A WDF_REQUEST_TYPE-typed value that identifies the request type to be queued. The only valid values are WdfRequestCreate, WdfRequestRead, WdfRequestWrite, and WdfRequestDeviceIoControl.
A BOOL value that specifies whether requests of the specified type are queued. TRUE indicates to enable queuing requests; FALSE indicates to disable queuing requests.
ConfigureRequestDispatching returns S_OK if the operation succeeds. Otherwise, this method returns one of the error codes that are defined in Winerror.h.
The driver can call the ConfigureRequestDispatching method multiple times to configure how each request type is dispatched to the I/O queue.
The following code example shows how to configure forwarding for IOCTL requests.
// // Configure forwarding for IOCTL requests // HRESULT hr = m_FxQueue->ConfigureRequestDispatching( WdfRequestDeviceIoControl, true );
|End of support||Unavailable in UMDF 2.0 and later.|
|Minimum UMDF version||1.5|
|Header||wudfddi.h (include Wudfddi.h)|