функция обратного вызова 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 см. в разделе Управление состоянием общего целевого объекта ввода-вывода.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Минимальная версия UMDF | 2,0 |
| Верхняя часть | wdfiotarget.h (включая Wdf.h) |
| IRQL | PASSIVE_LEVEL |