Метод IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove (wudfddi.h)
[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]
Функция обратного вызова событий на основе UMDF OnRemoteTargetQueryRemove определяет, можно ли остановить и удалить устройство удаленного целевого объекта ввода-вывода.
Синтаксис
BOOL OnRemoteTargetQueryRemove(
[in] IWDFRemoteTarget *pWdfRemoteTarget
);
Параметры
[in] pWdfRemoteTarget
Указатель на интерфейс IWDFRemoteTar get удаленного целевого объекта, представляющего удаленный целевой объект ввода-вывода. Драйвер получает этот указатель при вызове IWDFDevice2::CreateRemoteTarget.
Возвращаемое значение
Если драйвер определяет, что устройство может быть остановлено и удалено, функция обратного вызова событий OnRemoteTargetQueryRemove должна возвращать TRUE. В противном случае функция обратного вызова должна возвращать FALSE.
Замечания
Если драйвер предоставляет функцию обратного вызова события OnRemoteTargetQueryRemove, функция обратного вызова должна определить, должна ли операционная система разрешить удаление устройства. Если драйвер определяет, что устройство можно удалить, он должен выполнить следующие действия:
- Выполните все действия, необходимые для остановки ввода-вывода в удаленный целевой объект.
- Вызов IWDFRemoteTarget::CloseForQueryRemove.
- Верните TRUE, чтобы указать, что удаление может произойти.
Если драйвер не предоставляет эту функцию обратного вызова, платформа вызывает IWDFRemoteTarget::CloseForQueryRemove для драйвера. Другими словами, платформа всегда позволяет удалить устройство, если драйвер не предоставляет функцию обратного вызова событий OnRemoteTargetQueryRemove.
Дополнительные сведения о функции обратного вызова событий OnRemoteTargetQueryRemov e см. в управлении состоянием общего объекта ввода-вывода вUMDF.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.9 |
| заголовка | wudfddi.h (include Wudfddi.h) |