WDF_IO_TARGET_PURGE_IO_ACTION enumeration (wdfiotarget.h)

[Applies to KMDF and UMDF]

The WDF_IO_TARGET_PURGE_IO_ACTION enumeration identifies the actions that the framework can take when a driver calls WdfIoTargetPurge to purge an I/O target.

Syntax

typedef enum _WDF_IO_TARGET_PURGE_IO_ACTION {
  WdfIoTargetPurgeIoUndefined = 0,
  WdfIoTargetPurgeIoAndWait = 1,
  WdfIoTargetPurgeIo = 2
} WDF_IO_TARGET_PURGE_IO_ACTION;

Constants

WdfIoTargetPurgeIoUndefined Value: 0 Reserved for system use.
WdfIoTargetPurgeIoAndWait Value: 1 The framework attempts to cancel all of the I/O requests in the target's queue, and waits until all delivered requests are completed or canceled, before WdfIoTargetPurge returns. If the framework receives additional requests for the queue, it completes them with a completion status value of STATUS_INVALID_DEVICE_STATE.
WdfIoTargetPurgeIo Value: 2 The framework attempts to cancel all of the target queue's I/O requests, before WdfIoTargetPurge returns.

Remarks

The WDF_IO_TARGET_PURGE_IO_ACTION enumeration is used as an input parameter to the WdfIoTargetPurge method.

If your driver specifies the WdfIoTargetPurgeIoAndWait flag, the driver must not call WdfIoTargetPurge from a request handler, a CompletionRoutine callback function, or an EvtUsbTargetPipeReadersFailed callback function.

Requirements

Requirement	Value
Minimum KMDF version	1.11
Minimum UMDF version	2.0
Header	wdfiotarget.h (include Wdf.h)

See also

WDF_IO_TARGET_STATE

WdfIoTargetPurge