Метод IPnpCallback::OnQueryRemove (wudfddi.h)

  • Статья

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

Метод OnQueryRemove уведомляет драйвер перед удалением устройства с компьютера.

Синтаксис

HRESULT OnQueryRemove(
  [in] IWDFDevice *pWdfDevice
);

Параметры

[in] pWdfDevice

Указатель на интерфейс IWDFDevice для объекта устройства, который будет удален.

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

Если драйвер определяет, что устройство можно остановить и удалить, метод обратного вызова OnQueryRemove должен возвращать S_OK или другой код состояния, для которого ЗНАЧЕНИЕ SUCCEEDED(status) равно TRUE. В противном случае он должен возвращать код состояния, для которого ЗНАЧЕНИЕ SUCCEEDED(status) равно FALSE. Коды ошибок HRESULT определяются в Winerror.h. Не возвращайте HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).

Этот метод должен использовать макрос HRESULT_FROM_NT для возврата определенного значения HRESULT для возврата состояния клиенту режима ядра. Дополнительные сведения см. в разделе Поддержка клиентов в режиме ядра.

Комментарии

Драйвер регистрирует интерфейс IPnpCallback при вызове метода IWDFDriver::CreateDevice для создания объекта устройства.

Платформа не синхронизирует функцию обратного вызова OnQueryRemove с другими функциями обратного вызова PnP и управления питанием.

Дополнительные сведения о методе обратного вызова OnQueryRemove см. в разделе Пользователь отключает устройство.

Требования

Требование Значение
Целевая платформа Windows
Header wudfddi.h (включая Wudfddi.h)

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

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice