IOCTL_PMI_GET_MEASUREMENT IOCTL(pmi.h)

아티클
02/07/2025

IOCTL_PMI_GET_MEASUREMENT 요청은 파워 미터에서 현재 측정 데이터를 반환합니다.

주 코드

입력 버퍼

IRP의 AssociatedIrp.SystemBuffer 멤버가 가리키는 초기자 할당 출력 버퍼입니다.

입력 버퍼 길이

IRP의 현재 I/O 스택 위치(IO_STACK_LOCATION)의 Parameters.DeviceIoControl.OutputBufferLength 멤버는 IRP의 AssociatedIrp.SystemBuffer 멤버가 가리키는 초기자 할당 출력 버퍼의 크기(바이트)로 설정됩니다. 이 크기는 sizeof(PMI_MEASUREMENT_DATA)보다 크거나 같아야 합니다. 그렇지 않으면 오류 상태가 STATUS_BUFFER_TOO_SMALL 요청이 실패합니다.

출력 버퍼

요청이 성공적으로 완료되면 AssociatedIrp.SystemBuffer 멤버가 가리키는 출력 버퍼에 PMI_MEASUREMENT_DATA 구조가 포함됩니다. 이 구조에는 요청된 측정 데이터가 포함됩니다.

출력 버퍼 길이

PMI_MEASUREMENT_DATA 구조체의 크기입니다.

상태 블록

Information 멤버는 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 포함)