Метод IPnpCallbackHardware::OnPrepareHardware (wudfddi.h)
[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]
Метод onPrepareHardware уведомляет драйвер о доступности указанного оборудования.
Синтаксис
HRESULT OnPrepareHardware(
[in] IWDFDevice *pWdfDevice
);
Параметры
[in] pWdfDevice
Указатель на интерфейс IWDFDevice для объекта устройства, чтобы сделать его доступным.
Возвращаемое значение
OnPrepareHardware возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h. Не возвращайте HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).
Если OnPrepareHardware возвращает код ошибки, платформа по-прежнему вызывает метод IPnpCallbackHardware::OnReleaseHardware. Метод OnReleaseHardware может освободить ресурсы, выделенные во время вызова OnPrepareHardware. Так как OnReleaseHardware должны освободить ресурсы как для успешного, так и для случаев сбоя OnPrepareHardware, он должен иметь возможность обрабатывать очистку частичных ресурсов.
Этот метод должен использовать макрос HRESULT_FROM_NT для возврата определенного значения HRESULT для возврата состояния клиенту в режиме ядра. Дополнительные сведения см. в поддержке клиентов в режиме ядра.
Замечания
Драйвер регистрирует интерфейс IPnpCallbackHardware при вызове метода IWDFDriver::CreateDevice для создания объекта устройства.
Получение вызова метода OnPrepareHardware эквивалентно драйверу модели драйвера Microsoft Windows (WDM), получающего IRP_MN_START_DEVICE IRP.
Дополнительные сведения см. в разделе Поиск и сопоставление аппаратных ресурсов вдрайвера UMDF.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Виндоус |
| заголовка | wudfddi.h (include Wudfddi.h) |
См. также
IPnpCallbackHardware2::OnPrepareHardware