IOCTL_PMI_GET_CONFIGURATION IOCTL(pmi.h)

아티클
02/07/2025

IOCTL_PMI_GET_CONFIGURATION 요청은 파워 미터의 현재 구성에 대한 정보를 반환합니다.

주 코드

입력 버퍼

IRP(I/O 요청 패킷)의 AssociatedIrp.SystemBuffer 멤버는 요청에 대한 입력 버퍼 및 출력 버퍼로 사용되는 초기자 할당 버퍼를 가리킵니다. 입력 시 이 버퍼에는 버전 및 ConfigurationType 멤버가 유효한 값으로 설정된 PMI_CONFIGURATION 구조체가 포함됩니다. ConfigurationType 멤버에는 파워 미터에서 검색할 구성 정보의 형식을 지정하는 PMI_CONFIGURATION_TYPE 열거형 값이 포함되어 있습니다. 이 값은 출력 버퍼에 쓸 구성 정보의 형식도 결정합니다.

입력 버퍼 길이

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

출력 버퍼

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

출력 버퍼 길이

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

상태 블록

Information 멤버는 PMI_CONFIGURATION 구조체의 크기(바이트)로 설정됩니다.

상태 멤버는 다음 값 중 하나로 설정됩니다.

STATUS_BUFFER_TOO_SMALL

IRPParameters.DeviceIoControl.OutputBufferLength 멤버가 PMI_CONFIGURATION 구조체의 크기(바이트)보다 작습니다.

STATUS_INVALID_PARAMETER

초기자가 할당한 입력 버퍼에 잘못된 PMI_CONFIGURATION_TYPE 값이 포함되어 있습니다.

STATUS_SUCCESS

PMI 인터페이스를 지원하는 WDM 드라이버가 IOCTL 요청을 성공적으로 완료했습니다.

발언

IOCTL_PMI_GET_CONFIGURATION 요청은 파워 미터의 현재 구성을 쿼리합니다. 입력 PMI_CONFIGURATION_TYPE 열거형 값은 반환할 구성 데이터의 형식을 지정합니다. 출력 버퍼의 데이터 형식 및 내용은 요청된 데이터에 따라 달라집니다.

다음 표에서는 지정된 PMI_CONFIGURATION_TYPE 열거형 값에 대해 반환되는 데이터 형식을 설명합니다.

PMI_CONFIGURATION_TYPE 값	묘사
PmiBudgetingConfiguration	파워 미터의 예산 구성에 대한 정보를 포함하는 PMI_BUDGETING_CONFIGURATION 구조체입니다.
PmiMeasurementConfiguration	파워 미터의 측정 구성에 대한 정보를 포함하는 PMI_MEASUREMENT_CONFIGURATION 구조체입니다.
PmiThresholdConfiguration	전원 측정기의 임계값 구성에 대한 정보를 포함하는 PMI_THRESHOLD_CONFIGURATION 구조체입니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 7, Windows Server 2008 R2 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
헤더	pmi.h(Pmi.h 포함)