EVT_WDF_IO_TARGET_REMOVE_CANCELED callback function (wdfiotarget.h)

[Applies to KMDF and UMDF]

A driver's EvtIoTargetRemoveCanceled event callback function performs operations when the removal of a specified remote I/O target is canceled.

Syntax

EVT_WDF_IO_TARGET_REMOVE_CANCELED EvtWdfIoTargetRemoveCanceled;

void EvtWdfIoTargetRemoveCanceled(
  [in] WDFIOTARGET IoTarget
)
{...}

Parameters

[in] IoTarget

A handle to an I/O target object.

Return value

None

Remarks

To register an EvtIoTargetRemoveCanceled callback function, place the callback function's address in the I/O target's WDF_IO_TARGET_OPEN_PARAMS structure.

If the driver's EvtIoTargetQueryRemove callback function called WdfIoTargetCloseForQueryRemove, the driver's EvtIoTargetRemoveCanceled callback function must call WdfIoTargetOpen to re-enable sending I/O requests to the I/O target. When the driver calls WdfIoTargetOpen, it can specify WdfIoTargetOpenReopen for the Type member of the WDF_IO_TARGET_OPEN_PARAMS structure.

If the driver did not provide an EvtIoTargetQueryRemove callback function, the driver's EvtIoTargetRemoveCanceled callback function can optionally call WdfIoTargetOpen and specify WdfIoTargetOpenReopen.

The optional EvtIoTargetRemoveCanceled callback function should perform any additional operations that might be necessary before the driver resumes sending I/O requests to the I/O target.

For more information about the EvtIoTargetRemoveCanceled callback function, see Controlling a General I/O Target's State.

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfiotarget.h (include Wdf.h)
IRQL PASSIVE_LEVEL

See also

EvtIoTargetQueryRemove

EvtIoTargetRemoveComplete

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetCloseForQueryRemove

WdfIoTargetOpen