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 |