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
目标平台 Windows
标头 hwnclx.h
Library Mshwnclxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

硬件通知支持

硬件通知参考