Метод IPnpCallbackHardware::OnReleaseHardware (wudfddi.h)

Статья
02/07/2025

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

Метод OnReleaseHardware уведомляет драйвер выполнять операции, необходимые при отсутствии доступа к указанному оборудованию.

Синтаксис

HRESULT OnReleaseHardware(
  [in] IWDFDevice *pWdfDevice
);

Параметры

[in] pWdfDevice

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

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

OnReleaseHardware возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h. Не возвращайте HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).

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

Замечания

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

Метод OnReleaseHardware должен освободить ресурсы, выделенные во время вызова IPnpCallbackHardware::OnPrepareHardware метод OnPrepareHardware успешно или неудачно. Поэтому OnReleaseHardware должны иметь возможность обрабатывать очистку частичных ресурсов.

Дополнительные сведения см. в разделе Поиск и сопоставление аппаратных ресурсов вдрайвера UMDF.