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


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

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

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

Синтаксис

HRESULT OnReleaseHardware(
  [in] IWDFDevice3        *pWdfDevice,
  [in] IWDFCmResourceList *pWdfResourcesTranslated
);

Параметры

[in] pWdfDevice

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

[in] pWdfResourcesTranslated

Указатель на интерфейс IWDFCmResourceList для объекта framework resource-list, который определяет преобразованные аппаратные ресурсы, назначенные Plug and Play-менеджером устройству.

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

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

Комментарии

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

Метод OnReleaseHardware должен освободить ресурсы, которые были выделены во время вызова метода IPnpCallbackHardware2::OnPrepareHardware драйвера, независимо от того, успешно ли выполнено onPrepareHardware . Таким образом, OnReleaseHardware должна иметь возможность обрабатывать очистку частичных ресурсов.

Сведения об удалении объекта прерывания см. в разделе Удаление объекта прерывания.

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

Примеры

См. пример кода в IWDFDevice3::MapIoSpace.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.11
Верхняя часть wudfddi.h

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

IPnpCallbackHardware2

OnPrepareHardware