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

Статья
02/07/2025

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

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

Синтаксис

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

Параметры

[in] pWdfDevice

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

[in] pWdfResourcesRaw

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

[in] pWdfResourcesTranslated

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

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

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

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

Замечания

Метод IPnpCallbackHardware2::OnPrepareHardware отличается от метода IPnpCallbackHardware::OnPrepareHardware, который получает необработанные и переведенные ресурсы.

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

Примеры

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

Требования

Требование	Ценность
завершение поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа	Настольный
минимальная версия UMDF	1.11
заголовка	wudfddi.h

См. также

IPnpCallbackHardware2

OnReleaseHardware

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