WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE function (wdfio.h)

[Applies to KMDF and UMDF]

The WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE function initializes a driver's WDF_IO_QUEUE_CONFIG structure.

Syntax

void WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(
  [out] PWDF_IO_QUEUE_CONFIG       Config,
  [in]  WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);

Parameters

[out] Config

A pointer to the driver's WDF_IO_QUEUE_CONFIG structure.

[in] DispatchType

A WDF_IO_QUEUE_DISPATCH_TYPE enumerator that identifies the request dispatching type for the queue.

Return value

None

Remarks

Drivers should call WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE when creating a power-managed I/O queue that is a device's default queue. The WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE function zeros the specified WDF_IO_QUEUE_CONFIG structure and sets its Size member. It also sets the PowerManaged member to WdfUseDefault, sets the DefaultQueue member to TRUE, and stores the specified dispatching type in the DispatchType member.

Starting in KMDF version 1.9, if DispatchType is set to WdfIoQueueDispatchParallel, WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE sets the structure's NumberOfPresentedRequests member to -1. This value indicates that the framework can deliver an unlimited number of I/O requests to the driver.

For a code example that uses WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE, see WdfIoQueueCreate.

Requirements

See also

WDF_IO_QUEUE_CONFIG

WDF_IO_QUEUE_CONFIG_INIT

WDF_IO_QUEUE_DISPATCH_TYPE

WdfIoQueueCreate