Expand Minimize

WdfDeviceGetDefaultQueue method

[Applies to KMDF and UMDF]

The WdfDeviceGetDefaultQueue method returns a handle to a device's default I/O queue.

Syntax


WDFQUEUE WdfDeviceGetDefaultQueue(
  [in]  WDFDEVICE Device
);

Parameters

Device [in]

A handle to a framework device object.

Return value

If the operation succeeds, the method returns a handle to a framework queue object. If the driver did not create a default I/O queue for the device, the method returns NULL.

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

Remarks

For more information about default I/O queues, see Creating I/O Queues.

Examples

The following code example obtains a handle to a device's default I/O queue.


WDFQUEUE DefaultQueue;

DefaultQueue = WdfDeviceGetDefaultQueue(Device);

Requirements

Minimum KMDF version

1.0

Minimum UMDF version

2.0

Header

Wdfdevice.h (include Wdf.h)

Library

Wdf01000.sys (KMDF);
WUDFx02000.dll (UMDF)

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

DriverCreate, KmdfIrql, KmdfIrql2

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.