WdfRequestGetIoQueue function (wdfrequest.h)

[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

[in] 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

Requirement Value
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(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

See also

WdfIoQueueGetDevice