IOCTL_PMI_SET_CONFIGURATION IOCTL (pmi.h)

IOCTL_PMI_SET_CONFIGURATION请求设置功率计的配置数据。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

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

IRPParameters.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 开始,功率计还可以支持对其预算信息具有读/写权限。 有关详细信息,请参阅 PMI_REPORTED_CAPABILITIES
 

要求

要求
最低受支持的客户端 在 Windows 7、Windows Server 2008 R2 和更高版本的 Windows 操作系统中可用。
标头 pmi.h (包括 Pmi.h)

另请参阅

IO_STACK_LOCATION

IRP

PMI_CONFIGURATION

PMI_REPORTED_CAPABILITIES