IOCTL_PMI_SET_CONFIGURATION IOCTL (pmi.h)
IOCTL_PMI_SET_CONFIGURATION请求设置功率计的配置数据。
主要代码
输入缓冲区
I/O 请求数据包的 AssociatedIrp.SystemBuffer 成员 (IRP) 指向包含 PMI_CONFIGURATION 结构的发起方分配的输入缓冲区。 此结构包含配置数据。
输入缓冲区长度
IRP 当前 I/O 堆栈位置的 Parameters.DeviceIoControl.InputBufferLength 成员 (IO_STACK_LOCATION) 设置为 AssociatedIrp.SystemBuffer 成员指向的输入缓冲区的大小(以字节为单位)。 此大小必须大于或等于 sizeof (PMI_CONFIGURATION) ,否则请求将失败并出现错误状态STATUS_BUFFER_TOO_SMALL。
输出缓冲区
无。
输出缓冲区长度
无。
状态块
信息成员设置为PMI_CONFIGURATION结构的大小(以字节为单位)。
Status 成员设置为以下值之一:
STATUS_BUFFER_TOO_SMALL
IRP 的 Parameters.DeviceIoControl.OutputBufferLength 成员小于PMI_CONFIGURATION结构的大小(以字节为单位)。
STATUS_SUCCESS
支持 PMI 接口的 WDM 驱动程序已成功完成 IOCTL 请求。
注解
IOCTL_PMI_SET_CONFIGURATION请求设置功率计的配置参数。 IRP 的 AssociatedIrp.SystemBuffer 成员引用包含 PMI_CONFIGURATION 结构的缓冲区。 此结构的 ConfigurationType 成员包含有关在功率计中设置的 PMI 配置数据类型的信息。
只有功率计支持的具有读/写权限的 PMI 配置数据可以使用 IOCTL_PMI_SET_CONFIGURATION集请求进行更改。 更改只读 PMI 配置数据的 IOCTL_PMI_SET_CONFIGURATION 集请求将失败,并且不会更改电表上的数据。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows 7、Windows Server 2008 R2 和更高版本的 Windows 操作系统中可用。 |
标头 | pmi.h (包括 Pmi.h) |