Метод 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. В противном случае он должен вернуть код состояния, для которого УСПЕШНО(состояние) равно FALSE. Коды ошибок HRESULT определены в Winerror.h. Не возвращайте HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).
Этот метод должен использовать макрос HRESULT_FROM_NT для возврата определенного значения HRESULT для возврата состояния клиенту в режиме ядра. Дополнительные сведения см. в поддержке клиентов в режиме ядра.
Замечания
Драйвер регистрирует интерфейс IPnpCallback при вызове метода IWDFDriver::CreateDevice для создания объекта устройства.
Платформа не синхронизирует функцию обратного вызова OnQueryStop OnQueryStop с другими функциями обратного вызова PnP и управления питанием.
OnQueryStop не вызывается в платформах версии 1.7 и более ранних версий.
Дополнительные сведения о методе обратного вызова OnQueryS top см. в диспетчера PnP Manager.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Виндоус |
| заголовка | wudfddi.h (include Wudfddi.h) |