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

Статья
08/07/2023

Регистрирует драйвер клиента уведомлений оборудования и его функции обратного вызова с расширением класса. Эта функция должна вызываться при загрузке драйвера клиента и вызове подпрограммы 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
Целевая платформа	Windows
Header	hwnclx.h
Библиотека	Mshwnclxstub.lib
IRQL	PASSIVE_LEVEL

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

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

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

Share via