Метод IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove (wudfddi.h)

  • Статья

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

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

Синтаксис

BOOL OnRemoteTargetQueryRemove(
  [in] IWDFRemoteTarget *pWdfRemoteTarget
);

Параметры

[in] pWdfRemoteTarget

Указатель на интерфейс IWDFRemoteTarget удаленного целевого объекта, представляющего удаленный целевой объект ввода-вывода. Драйвер получает этот указатель при вызове IWDFDevice2::CreateRemoteTarget.

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

Если драйвер определяет, что устройство можно остановить и удалить, функция обратного вызова события OnRemoteTargetQueryRemove должна возвращать значение TRUE. В противном случае функция обратного вызова должна возвращать значение FALSE.

Комментарии

Если драйвер предоставляет функцию обратного вызова события OnRemoteTargetQueryRemove , функция обратного вызова должна определить, должна ли операционная система разрешить удаление устройства. Если драйвер определяет, что устройство можно удалить, он должен сделать следующее:

  1. Выполните все действия, связанные с драйвером, чтобы остановить ввод-вывод в удаленный целевой объект.
  2. Вызовите IWDFRemoteTarget::CloseForQueryRemove.
  3. Возвращает значение TRUE , чтобы указать, что удаление может произойти.
Если драйвер определяет, что устройство не должно быть удалено, функция обратного вызова должна возвращать значение FALSE. Как правило, драйверы не должны возвращать значение FALSE, так как возвращаемое значение FALSE может привести к перезапуску Windows.

Если драйвер не предоставляет эту функцию обратного вызова, платформа вызывает IWDFRemoteTarget::CloseForQueryRemove для драйвера. Другими словами, платформа всегда позволяет удалить устройство, если драйвер не предоставляет функцию обратного вызова события OnRemoteTargetQueryRemove .

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

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1,9
Верхняя часть wudfddi.h (включая Wudfddi.h)

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

IRemoteTargetCallbackRemoval

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete