Метод IPnpCallback::OnQueryStop (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]
Метод OnQueryStop уведомляет драйвер перед остановкой устройства.
Синтаксис
HRESULT OnQueryStop(
[in] IWDFDevice *pWdfDevice
);
Параметры
[in] pWdfDevice
Указатель на интерфейс IWDFDevice для объекта устройства, которое будет остановлено.
Возвращаемое значение
Если драйвер определяет, что устройство может быть остановлено, метод обратного вызова OnQueryStop должен возвращать S_OK или другой код состояния, для которого SUCCEEDED(status) равно TRUE. В противном случае он должен вернуть код состояния, для которого ЗНАЧЕНИЕ SUCCEEDED(status) равно FALSE. Коды ошибок HRESULT определяются в Winerror.h. Не возвращайте HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).
Этот метод должен использовать макрос HRESULT_FROM_NT для возврата определенного значения HRESULT для возврата состояния клиенту режима ядра. Дополнительные сведения см. в разделе Поддержка клиентов в режиме ядра.
Комментарии
Драйвер регистрирует интерфейс IPnpCallback при вызове метода IWDFDriver::CreateDevice для создания объекта устройства.
Платформа не синхронизирует функцию обратного вызова OnQueryStop с другими функциями обратного вызова PnP и управления питанием.
OnQueryStop не вызывается в платформе версии 1.7 и более ранних версий.
Дополнительные сведения о методе обратного вызова OnQueryStop см. в разделе Перераспределяет системные ресурсы диспетчера PnP.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | wudfddi.h (включая Wudfddi.h) |