Метод 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) |