Метод IPnpCallbackHardware::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] 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.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | wudfddi.h (включая Wudfddi.h) |
См. также раздел
IPnpCallbackHardware2::OnReleaseHardware