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

[Применимо к KMDF и UMDF]

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

Синтаксис

EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;

NTSTATUS EvtWdfIoTargetQueryRemove(
  [in] WDFIOTARGET IoTarget
)
{...}

Параметры

[in] IoTarget

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

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

Функцияобратного вызова EvtIoTargetQueryRemove должна возвращать STATUS_SUCCESS, если драйвер определяет, что платформа может безопасно удалить устройство указанного целевого объекта ввода-вывода. В противном случае эта функция обратного вызова должна возвращать STATUS_UNSUCCESSFUL.

Комментарии

Если функция обратного вызова EvtIoTargetQueryRemove драйвера возвращает STATUS_SUCCESS, система позволяет удалить устройство целевого объекта ввода-вывода, если другой драйвер не возвращает STATUS_UNSUCCESSFUL.

Чтобы зарегистрировать функцию обратного вызова EvtIoTargetQueryRemove , поместите адрес функции обратного вызова в структуру WDF_IO_TARGET_OPEN_PARAMS целевого объекта ввода-вывода. Функция обратного вызова EvtIoTargetQueryRemove необязательна. Отсутствие этой функции обратного вызова эквивалентно возврату STATUS_SUCCESS.

Функция обратного вызова EvtIoTargetQueryRemove должна вызывать WdfIoTargetCloseForQueryRemove, если драйвер определяет, что диспетчер PnP может безопасно удалить целевое устройство.

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

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

Требования

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

EvtIoTargetRemoveCanceled

EvtIoTargetRemoveComplete

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetCloseForQueryRemove