Метод IDriverEntry::OnInitialize (wudfddi.h)

  • Статья

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

Метод OnInitialize выполняет все операции, необходимые для инициализации драйвера.

Синтаксис

HRESULT OnInitialize(
  [in] IWDFDriver *pWdfDriver
);

Параметры

[in] pWdfDriver

Указатель на интерфейс IWDFDriver для объекта драйвера платформы, который представляет драйвер, загруженный в хост-процесс.

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

OnInitialize возвращает S_OK, если драйвер завершил глобальную инициализацию. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h. Если драйвер возвращает код ошибки, платформа не загрузит драйвер.

Комментарии

Платформа создает новый объект драйвера для каждого драйвера, загруженного в процесс узла драйвера. Когда драйвер входит в систему, платформа вызывает OnInitialize для уведомления драйвера и передает интерфейс IWDFDriver в вызове.

Требования

Требование Значение
Целевая платформа Windows
Header wudfddi.h (включая Wudfddi.h)

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

IDriverEntry

IWDFDriver