HWN_CLIENT_SET_STATE回调函数 (hwnclx.h)

  • 项目

由客户端驱动程序实现以设置硬件通知组件状态。 当用户想要更改驱动程序的状态时，会调用它。

语法

HWN_CLIENT_SET_STATE HwnClientSetState;

NTSTATUS HwnClientSetState(
  [in]  PVOID Context,
  [in]  PVOID Buffer,
  [in]  ULONG BufferLength,
  [out] PULONG BytesWritten
)
{...}

参数

[in] Context

指向客户端驱动程序的上下文信息的指针。 此内存空间可供客户端驱动程序使用。 它由 WdfDeviceCreate 作为框架对象上下文空间的一部分进行分配。 有关详细信息，请参阅 HWN_CLIENT_REGISTRATION_PACKET 和 框架对象上下文空间。

[in] Buffer

BufferLength 字节的缓冲区，包含HWN_HEADER结构，包括指定要设置的硬件通知的一个或多个HWN_SETTINGS结构。

[in] BufferLength

缓冲区的大小（以字节为单位）。

[out] BytesWritten

指向变量的指针，该变量指示函数写入的字节数。

返回值

如果操作成功，则返回STATUS_SUCCESS。 否则，返回相应的 NTSTATUS 错误代码。

注解

通过设置 HWN_CLIENT_REGISTRATION_PACKET 的相应成员，然后调用 HwNRegisterClient 来注册此回调函数的实现。

要求

要求 值
最低受支持的客户端 Windows 10 版本 1709
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 hwnclx.h
IRQL PASSIVE_LEVEL

另请参阅

硬件通知支持

硬件通知参考