WdfIoQueueStart method

[Applies to KMDF and UMDF]

The WdfIoQueueStart method enables an I/O queue to start receiving and delivering new I/O requests.

Syntax


VOID WdfIoQueueStart(
  [in]  WDFQUEUE Queue
);

Parameters

Queue [in]

A handle to a framework queue object.

Return value

None.

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

Remarks

If I/O requests are in the I/O queue when the driver calls WdfIoQueueStart, the same thread that calls WdfIoQueueStart can call the driver's request handlers before WdfIoQueueStart returns. Therefore, when the driver calls WdfIoQueueStart, it must not hold any locks that the request handlers attempt to acquire. Otherwise, a deadlock can result.

For more information about the WdfIoQueueStart method, see Managing I/O Queues.

Examples

The following code example purges a specified I/O queue and then restarts the queue.


WdfIoQueuePurge(
                ReadQueue, 
                WDF_NO_EVENT_CALLBACK, 
                WDF_NO_CONTEXT
                );
WdfIoQueueStart(ReadQueue);

Requirements

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, KmdfIrql, KmdfIrql2

See also

WdfIoQueueStop
WdfIoQueuePurge

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft