IWDFIoQueue::ConfigureRequestDispatching method (wudfddi.h)

Article
02/22/2024

[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.

Syntax

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

Parameters

[in] RequestType

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

[in] Forward

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

Requirement	Value
End of support	Unavailable in UMDF 2.0 and later.
Target Platform	Desktop
Minimum UMDF version	1.5
Header	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Share via