Функция HwNRegisterClient (hwnclx.h)

Регистрирует драйвер клиента уведомлений оборудования и его функции обратного вызова с расширением класса. Эта функция должна вызываться при загрузке драйвера клиента, а для инициализации вызывается DriverEntry подпрограмма.

Синтаксис

FORCEINLINE NTSTATUS  HwNRegisterClient(
  _In_    WDFDRIVER                        Driver,
  _Inout_ PHWN_CLIENT_REGISTRATION_PACKET  RegistrationPacket,
  _In_    PUNICODE_STRING                  RegistryPath
);

Параметры

[in] Driver

Обработка объекта драйвера платформы драйверов клиента.

[in, out] RegistrationPacket

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

[in] RegistryPath

Указатель на UNICODE_STRING структуру, содержащую путь к разделу реестра драйвера клиента.

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

Возвращает STATUS_SUCCESS, если функция выполнена успешно. Возвращает STATUS_INVALID_PARAMETER, если не удается найти соответствующий драйвер клиента. В противном случае возвращается одно из значений состояния ошибки, определенных в Ntstatus.h.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 10 версии 1709
минимальный поддерживаемый сервер Windows Server 2016
целевая платформа Виндоус
заголовка hwnclx.h
библиотеки Mshwnclxstub.lib
IRQL PASSIVE_LEVEL

См. также

поддержка уведомлений о оборудовании

справочник по уведомлениям о оборудовании