IOCTL_PMI_GET_MEASUREMENT IOCTL (pmi.h)

IOCTL_PMI_GET_MEASUREMENT 请求从电表返回当前度量数据。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

由 IRP 的 AssociatedIrp.SystemBuffer 成员指向的发起程序分配的输出缓冲区。

输入缓冲区长度

Parameters.DeviceIoControl.OutputBufferLength IRP 当前 I/O 堆栈位置 (IO_STACK_LOCATION) 的成员设置为由 IRP AssociatedIrp.SystemBuffer 成员指向的发起程序分配的输出缓冲区的大小(以字节为单位)。 此大小必须大于或等于 sizeofPMI_MEASUREMENT_DATA),否则请求失败并出现错误状态STATUS_BUFFER_TOO_SMALL。

输出缓冲区

如果请求成功完成,则 AssociatedIrp.SystemBuffer 成员指向的输出缓冲区包含 PMI_MEASUREMENT_DATA 结构。 此结构包含请求的度量数据。

输出缓冲区长度

PMI_MEASUREMENT_DATA 结构的大小。

状态块

信息 成员设置为 PMI_MEASUREMENT_DATA 结构的大小(以字节为单位)。

状态 成员设置为以下值之一:

STATUS_BUFFER_TOO_SMALL

IRPParameters.DeviceIoControl.OutputBufferLength 成员小于 PMI_MEASUREMENT_DATA 结构的大小(以字节为单位)。

STATUS_SUCCESS

支持 PMI 接口的 WDM 驱动程序已成功完成 IOCTL 请求。

言论

IOCTL_PMI_GET_MEASUREMENT 请求从电源表查询当前测量数据。 此度量数据是根据电表的测量配置参数采样和平均值的。 度量配置参数通过输入 PMI_CONFIGURATION_TYPE 值为 PmiMeasurementConfigurationIOCTL_PMI_GET_CONFIGURATION 请求进行查询。

要求

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

另请参阅

IOCTL_PMI_GET_CAPABILITIES

IOCTL_PMI_GET_CONFIGURATION

IO_STACK_LOCATION

IRP

PMI_CONFIGURATION_TYPE

PMI_MEASUREMENT_DATA