WdfRequestGetIoQueue function

[Applies to KMDF and UMDF]

The WdfRequestGetIoQueue method returns a handle to the framework queue object from which a specified I/O request was delivered.

Syntax

WDFQUEUE WdfRequestGetIoQueue(
  _In_ WDFREQUEST Request
);

Parameters

Request

A handle to a framework request object.

Return Value

WdfRequestGetIoQueue returns a handle to a framework queue object. If the request was created by the driver, or if the driver has already completed the specified I/O request, the method returns NULL.

A bug check occurs if the driver supplies an invalid object handle.

Remarks

For more information about WdfRequestGetIoQueue, see Obtaining Information About an I/O Request.

Examples

The following code example obtains a handle to the device object that represents the device that a request belongs to.

WDFDEVICE  device;

device = WdfIoQueueGetDevice(WdfRequestGetIoQueue(Request));

Requirements

   
Target Platform Universal
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfrequest.h (include Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL "<=DISPATCH_LEVEL"
DDI compliance rules DriverCreate, InvalidReqAccess, InvalidReqAccessLocal, KmdfIrql, KmdfIrql2

See Also

WdfIoQueueGetDevice

Send comments about this topic to Microsoft