WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE function

[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

Config [out]

A pointer to the driver's WDF_IO_QUEUE_CONFIG structure.

DispatchType [in]

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

Target platform

Universal

Minimum KMDF version

1.0

Minimum UMDF version

2.0

Header

Wdfio.h (include Wdf.h)

See also

WDF_IO_QUEUE_CONFIG
WDF_IO_QUEUE_CONFIG_INIT
WDF_IO_QUEUE_DISPATCH_TYPE
WdfIoQueueCreate

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft