Метод 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 для объекта списка ресурсов платформы, который определяет преобразованные аппаратные ресурсы, назначенные диспетчеру 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 |