Поделиться через


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

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

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice