IWDFDevice::ConfigureRequestDispatching method

The ConfigureRequestDispatching method configures the queuing of I/O requests of the specified type to the specified I/O queue.

Syntax


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

Parameters

pQueue [in]

A pointer to the IWDFIoQueue interface for the I/O queue to configure.

RequestType [in]

A WDF_REQUEST_TYPE-typed value that identifies the request type to be queued. The only valid WDF_REQUEST_TYPE 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.

Examples

The following code example shows how to configure a queue.


    //
    // Create the control queue and configure forwarding for I/O control code (IOCTL) requests
    //
 if (S_OK == hr) {
        PCMyControlQueue controlQueue;
        hr = CMyControlQueue::CreateInstance(this, &controlQueue);
        if (S_OK == hr) {
            hr = controlQueue->Configure();
            if (S_OK == hr) {
                hr = m_FxDevice->ConfigureRequestDispatching(
                           controlQueue->GetFxQueue(),
                           WdfRequestDeviceIoControl,
                           true
                           );
            }
            controlQueue->Release();
        }
    }

Requirements

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

IWDFDevice
IWDFIoQueue
WDF_REQUEST_TYPE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft