WdfDeviceGetDefaultQueue function (wdfdevice.h)

Article
02/22/2024

[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

[in] Device

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

Requirement	Value
Target Platform	Universal
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(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Share via