функция обратного вызова EVT_WDF_IO_TARGET_REMOVE_COMPLETE (wdfiotarget.h)

  • Статья

[Относится к KMDF и UMDF]

Функция обратного вызова события EvtIoTargetRemoveComplete драйвера выполняет операции по завершении удаления указанного удаленного целевого объекта ввода-вывода.

Синтаксис

EVT_WDF_IO_TARGET_REMOVE_COMPLETE EvtWdfIoTargetRemoveComplete;

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

Параметры

[in] IoTarget

Дескриптор целевого объекта ввода-вывода.

Возвращаемое значение

None

Remarks

Чтобы зарегистрировать функцию обратного вызова EvtIoTargetRemoveComplete , поместите адрес функции обратного вызова в структуру WDF_IO_TARGET_OPEN_PARAMS целевого объекта ввода-вывода.

Платформа вызывает функцию обратного вызова EvtIoTargetRemoveComplete драйвера после того, как функция обратного вызова EvtIoTargetQueryRemove драйвера возвращает STATUS_SUCCESS или после неожиданного удаления устройства (неожиданное удаление).

Функция обратного вызова EvtIoTargetRemoveComplete драйвера должна окончательно закрыть удаленный целевой объект ввода-вывода, вызвав WdfIoTargetClose. Так как целевое устройство было удалено, функция обратного вызова EvtIoTargetRemoveComplete также должна выполнять любые дополнительные операции удаления целевого объекта, которые могут потребоваться, например освобождение системных ресурсов, выделенных драйвером при открытии целевого объекта.

Функция обратного вызова EvtIoTargetRemoveComplete является необязательной. Если драйвер не предоставляет эту функцию обратного вызова, платформа окончательно закрывает целевой объект ввода-вывода.

Дополнительные сведения о функции обратного вызова EvtIoTargetRemoveComplete см. в разделе Управление состоянием общего целевого объекта ввода-вывода.

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfiotarget.h (включая Wdf.h)
IRQL PASSIVE_LEVEL

См. также раздел

EvtIoTargetQueryRemove

EvtIoTargetRemoveCanceled

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetClose