IWDFIoQueue::ConfigureRequestDispatching method

The ConfigureRequestDispatching method configures the queuing of I/O requests of the given type.

Syntax


HRESULT ConfigureRequestDispatching(
  [in] WDF_REQUEST_TYPE RequestType,
  [in] BOOL             Forward
);

Parameters

RequestType [in]

A WDF_REQUEST_TYPE-typed value that identifies the request type to be queued. The only valid values are WdfRequestCreate, WdfRequestRead, WdfRequestWrite, and WdfRequestDeviceIoControl.

Forward [in]

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.

Return value

ConfigureRequestDispatching returns S_OK if the operation succeeds. Otherwise, this method returns one of the error codes that are defined in Winerror.h.

Remarks

The driver can call the ConfigureRequestDispatching method multiple times to configure how each request type is dispatched to the I/O queue.

Examples

The following code example shows how to configure forwarding for IOCTL requests.


    //
    // Configure forwarding for IOCTL requests
    //
    HRESULT hr = m_FxQueue->ConfigureRequestDispatching(
                                                        WdfRequestDeviceIoControl,
                                                        true
                                                        );


Requirements

Target platform

Desktop

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.5

Header

Wudfddi.h (include Wudfddi.h)

DLL

WUDFx.dll

See also

IWDFIoQueue
WDF_REQUEST_TYPE

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft