PMI_EVENT 구조체(pmi.h)

아티클
02/07/2025

PMI_EVENT 구조에는 PMI(파워 미터 인터페이스)를 통해 신호를 수신하는 전력 계량 및 예산 이벤트에 대한 정보가 포함되어 있습니다.

통사론

typedef struct _PMI_EVENT {
  ULONG          Version;
  PMI_EVENT_TYPE EventType;
} PMI_EVENT, *PPMI_EVENT;

회원

Version

이 구조체의 버전을 지정하는 값입니다. Windows 7, Windows Server 2008 R2 이상 버전의 Windows의 경우 이 값은 1이어야 합니다.

EventType

PMI 이벤트 형식을 지정하는 PMI_EVENT_TYPE 열거형 값입니다.

발언

PMI_EVENT 구조에는 전력 계량 또는 예산 이벤트에 대한 정보가 포함됩니다. PMI는 다음 중 하나가 발생할 때 파워 미터에 대한 이벤트를 생성합니다.

파워 미터의 전력 계량 또는 예산 기능이 변경되었습니다.
전원 측정기 전원 계량 또는 예산 구성이 변경되었습니다.
전원 측정기에서 모니터링되는 전원 공급 장치가 측정기에서 구성된 전원 임계값을 초과했습니다.
전원 측정기에서 모니터링하는 전원 공급 장치가 측정기 구성 전력 예산을 초과하거나 감소했습니다.

사용자 모드 서비스 또는 애플리케이션은 IOCTL(IOCTL_PMI_REGISTER_EVENT_NOTIFY I/O 컨트롤) 쿼리 요청을 통해 이러한 이벤트에 대한 알림을 등록합니다.

PMI_EVENT 구조체에는 이벤트에 대한 현재 PMI 데이터가 포함되어 있지 않습니다. EventType 멤버의 값에 따라 호출자는 PMI IOCTL 쿼리 요청을 통해 현재 PMI 데이터를 검색할 수 있습니다. 다음 표에서는 파워 미터에서 변경된 데이터를 쿼리 요청에 쿼리하는 데 사용할 PMI IOCTL에 대해 설명합니다.

EventType 값	PMI IOCTL	I/O 요청 패킷(IRP)
PmiCapabilitiesChangedEvent	IOCTL_PMI_GET_CAPABILITIES	AssociatedIrp.SystemBuffer 멤버는 PMI_CAPABILITIES_TYPE 열거형 값을 포함하는 초기자 할당 버퍼의 주소로 설정됩니다.
PmiConfigurationChangedEvent	IOCTL_PMI_GET_CONFIGURATION	AssociatedIrp.SystemBuffer 멤버는 PMI_CONFIGURATION_TYPE 열거형 값을 포함하는 초기자 할당 버퍼의 주소로 설정됩니다.
PmiThresholdEvent	IOCTL_PMI_GET_CONFIGURATION	AssociatedIrp.SystemBuffer 멤버는 PMI_CONFIGURATION_TYPE 열거형 값 또는 PmiThresholdConfiguration포함하는 초기자 할당 버퍼의 주소로 설정됩니다.
PmiBudgetEvent	IOCTL_PMI_GET_CONFIGURATION	AssociatedIrp.SystemBuffer 멤버는 PMI_CONFIGURATION_TYPE 열거형 값 또는 PmiBudgetConfiguration포함하는 초기자 할당 버퍼의 주소로 설정됩니다.
PmiAveragingIntervalChangedEvent	IOCTL_PMI_GET_CONFIGURATION	AssociatedIrp.SystemBuffer 멤버는 PMI_CONFIGURATION_TYPE 열거형 값 또는 PmiMeasurementConfiguration포함하는 초기자 할당 버퍼의 주소로 설정됩니다.

요구 사항

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