WDF_IO_TARGET_SENT_IO_ACTION - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// wdfiotarget.h

typedef enum _WDF_IO_TARGET_SENT_IO_ACTION {
  WdfIoTargetSentIoUndefined = 0,
  WdfIoTargetCancelSentIo,
  WdfIoTargetWaitForSentIoToComplete,
  WdfIoTargetLeaveSentIoPending
} WDF_IO_TARGET_SENT_IO_ACTION;

View the official Windows Driver Kit DDI reference
// wudfddi_types.h

typedef enum _WDF_IO_TARGET_SENT_IO_ACTION {
  WdfIoTargetSentIoUndefined,
  WdfIoTargetCancelSentIo,
  WdfIoTargetWaitForSentIoToComplete,
  WdfIoTargetLeaveSentIoPending,
  WdfIoTargetSentIoMaximum
} WDF_IO_TARGET_SENT_IO_ACTION;

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ne-wdfiotarget-_wdf_io_target_sent_io_action)

_WDF_IO_TARGET_SENT_IO_ACTION enumeration (wdfiotarget.h)

Description

[Applies to KMDF and UMDF]

The WDF_IO_TARGET_SENT_IO_ACTION enumeration identifies the actions that the framework can take when a driver calls WdfIoTargetStop to stop an I/O target.

Constants

WdfIoTargetSentIoUndefined:0

Reserved for system use.

WdfIoTargetCancelSentIo

Before the framework stops the I/O target, it will attempt to cancel I/O requests that are in the I/O target's queue. The framework cancels all of the target queue's I/O requests, and waits for all I/O requests to complete, before WdfIoTargetStop returns. The framework also attempts to cancel I/O requests that have left the I/O target's queue and entered lower drivers.

WdfIoTargetWaitForSentIoToComplete

Before the framework stops the I/O target, it will wait for I/O requests that are in the I/O target's queue to be completed. The framework completes all of the target queue's I/O requests, and calls each request's CompletionRoutine callback function, before WdfIoTargetStop returns.

WdfIoTargetLeaveSentIoPending

The framework will leave I/O requests in the I/O target's queue. The requests remain in the target's queue until the driver calls WdfIoTargetStart or the device is removed.

Remarks

The WDF_IO_TARGET_SENT_IO_ACTION enumeration is used as an input parameter to the WdfIoTargetStop method.

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

For the UMDF version of this enumeration, see WDF_IO_TARGET_SENT_IO_ACTION (UMDF).

See also

CompletionRoutine

WdfIoTargetStop


Windows Driver Kit DDI reference (ne-wudfddi_types-_wdf_io_target_sent_io_action)

_WDF_IO_TARGET_SENT_IO_ACTION enumeration (wudfddi_types.h)

Description

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

The WDF_IO_TARGET_SENT_IO_ACTION enumeration identifies the actions that the framework can take when a driver calls IWDFIoTargetStateManagement::Stop or IWDFRemoteTarget::Stop to stop an I/O target.

Constants

WdfIoTargetSentIoUndefined

Reserved for system use.

WdfIoTargetCancelSentIo

Before the framework stops the I/O target, it will attempt to cancel I/O requests that are in the I/O target's queue. The framework cancels all of the target queue's I/O requests before IWDFIoTargetStateManagement::Stop or IWDFRemoteTarget::Stop returns.

WdfIoTargetWaitForSentIoToComplete

Before the framework stops the I/O target, it will wait for I/O requests that are in the I/O target's queue to be completed. The framework completes all of the target queue's I/O requests, and calls each request's IRequestCallbackRequestCompletion::OnCompletion callback function, before IWDFIoTargetStateManagement::Stop or IWDFRemoteTarget::Stop returns.

WdfIoTargetLeaveSentIoPending

The framework will leave I/O requests in the I/O target's queue. The requests remain in the target's queue until the driver calls IWDFIoTargetStateManagement::Start or IWDFRemoteTarget::Start or the device is removed.

WdfIoTargetSentIoMaximum

Valid enumeration values were exceeded.

Remarks

The WDF_IO_TARGET_SENT_IO_ACTION enumeration is used as an input parameter to the IWDFIoTargetStateManagement::Stop and IWDFRemoteTarget::Stop methods.

If your driver specifies the WdfIoTargetWaitForSentIoToComplete flag, the driver must not call IWDFIoTargetStateManagement::Stop or IWDFRemoteTarget::Stop from a request handler, an IRequestCallbackRequestCompletion::OnCompletion callback function, or an IUsbTargetPipeContinuousReaderCallbackReadersFailed::OnReaderFailure callback function.

For the KMDF version of this enumeration, see WDF_IO_TARGET_SENT_IO_ACTION.

See also

WDF_IO_TARGET_SENT_IO_ACTION