WdfIoQueueGetDevice function (wdfio.h)

[Applies to KMDF and UMDF]

The WdfIoQueueGetDevice method returns a handle to the framework device object that a specified I/O queue belongs to.

Syntax

WDFDEVICE WdfIoQueueGetDevice(
  [in] WDFQUEUE Queue
);

Parameters

[in] Queue

A handle to a framework queue object.

Return value

WdfIoQueueGetDevice returns a handle to a framework device object.

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

Remarks

For more information about the WdfIoQueueGetDevice method, see Obtaining I/O Queue Properties.

Examples

The following code example obtains a handle to the framework device object that is associated with the I/O queue that contains a specified request.

WDFDEVICE  device;

device = WdfIoQueueGetDevice(WdfRequestGetIoQueue(Request));

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfio.h (include Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI compliance rules DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

See also

WdfRequestGetIoQueue