IOCTL_PMI_GET_MEASUREMENT IOCTL (pmi.h)
IOCTL_PMI_GET_MEASUREMENT 请求从电表返回当前度量数据。
主要代码
输入缓冲区
由 IRP 的 AssociatedIrp.SystemBuffer 成员指向的发起程序分配的输出缓冲区。
输入缓冲区长度
Parameters.DeviceIoControl.OutputBufferLength IRP 当前 I/O 堆栈位置 (IO_STACK_LOCATION) 的成员设置为由 IRP AssociatedIrp.SystemBuffer 成员指向的发起程序分配的输出缓冲区的大小(以字节为单位)。 此大小必须大于或等于 sizeof(PMI_MEASUREMENT_DATA),否则请求失败并出现错误状态STATUS_BUFFER_TOO_SMALL。
输出缓冲区
如果请求成功完成,则 AssociatedIrp.SystemBuffer 成员指向的输出缓冲区包含 PMI_MEASUREMENT_DATA 结构。 此结构包含请求的度量数据。
输出缓冲区长度
PMI_MEASUREMENT_DATA 结构的大小。
状态块
信息 成员设置为 PMI_MEASUREMENT_DATA 结构的大小(以字节为单位)。
状态 成员设置为以下值之一:
STATUS_BUFFER_TOO_SMALL
IRP 的 Parameters.DeviceIoControl.OutputBufferLength 成员小于 PMI_MEASUREMENT_DATA 结构的大小(以字节为单位)。
STATUS_SUCCESS
支持 PMI 接口的 WDM 驱动程序已成功完成 IOCTL 请求。
言论
IOCTL_PMI_GET_MEASUREMENT 请求从电源表查询当前测量数据。 此度量数据是根据电表的测量配置参数采样和平均值的。 度量配置参数通过输入 PMI_CONFIGURATION_TYPE 值为 PmiMeasurementConfiguration的 IOCTL_PMI_GET_CONFIGURATION 请求进行查询。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows 7、Windows Server 2008 R2 和更高版本的 Windows作系统中可用。 |
标头 | pmi.h (包括 Pmi.h) |