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) |