PMI_CONFIGURATION 구조체(pmi.h)
PMI_CONFIGURATION 구조에는 파워 미터의 현재 전력 계량 및 예산 구성에 대한 정보가 포함되어 있습니다.
통사론
typedef struct _PMI_CONFIGURATION {
ULONG Version;
USHORT Size;
PMI_CONFIGURATION_TYPE ConfigurationType;
union {
PMI_MEASUREMENT_CONFIGURATION MeasurementConfiguration;
PMI_BUDGETING_CONFIGURATION BudgetingConfiguration;
PMI_THRESHOLD_CONFIGURATION ThresholdConfiguration;
} Configuration;
} PMI_CONFIGURATION, *PPMI_CONFIGURATION;
회원
Version
이 구조체의 버전을 지정하는 값입니다. Windows 7, Windows Server 2008 R2 이상 버전의 Windows의 경우 이 값은 1이어야 합니다.
Size
구조체의 크기를 지정하는 값(바이트 단위)입니다.
ConfigurationType
Configuration 멤버의 데이터 형식을 지정하는 PMI_CONFIGURATION_TYPE 열거형 값입니다.
Configuration
지원되는 PMI(Power Meter Interface) 구성 구조의 통합입니다. ConfigurationType 멤버의 값에 따라 다음 구성 하위 멤버 중 하나가 다음 PMI 구성 구조를 참조하는 데 사용됩니다.
Configuration.MeasurementConfiguration
파워 미터의 예산 구성에 대한 정보를 포함하는 PMI_BUDGETING_CONFIGURATION 구조체입니다.
ConfigurationType 멤버가 PmiBudgetingConfiguration 설정된 경우 Configuration 멤버에는 이 구조체가 포함됩니다.
Configuration.BudgetingConfiguration
파워 미터의 측정 구성에 대한 정보를 포함하는 PMI_MEASUREMENT_CONFIGURATION 구조체입니다.
ConfigurationType 멤버가 PmiMeasurementConfiguration 설정된 경우 Configuration 멤버에는 이 구조체가 포함됩니다.
Configuration.ThresholdConfiguration
전원 측정기의 임계값 구성에 대한 정보를 포함하는 PMI_THRESHOLD_CONFIGURATION 구조체입니다.
ConfigurationType 멤버가 pmiThresoldConfiguration 설정된 경우 Configuration 멤버에는 이 구조체가 포함됩니다.
발언
PMI_CONFIGURATION 구조체는 파워 미터에서 지원하는 다양한 PMI 구성 설정을 쿼리하는 데 사용됩니다.
PMI 구성 정보는 IOCTL(IOCTL_PMI_GET_CONFIGURATION I/O 컨트롤) 쿼리 요청을 통해 반환됩니다. 이 쿼리 요청의 입력 데이터는 반환할 PMI 구성 데이터의 형식을 지정하는 PMI_CONFIGURATION_TYPE 열거자 값으로 설정됩니다.
IOCTL 쿼리 요청이 성공적으로 완료되면 요청은 PMI_CONFIGURATION 구조를 반환합니다. 이 구조체의 Configuration 멤버에는 요청된 PMI 구성 구조로 형식이 지정된 데이터가 포함됩니다.
예를 들어 pmiBudgetingConfiguration 입력 데이터 집합을 사용하여 IOCTL_PMI_GET_CONFIGURATION IOCTL 쿼리 요청이 수행되고 요청이 성공적으로 완료되면 요청은 멤버가 다음 값으로 설정된 PMI_CONFIGURATION 구조를 반환합니다.
- ConfigurationType 멤버는 PmiBudgetingConfiguration 설정됩니다.
- Configuration 멤버는 PMI_BUDGETING_CONFIGURATION 구조체로 형식이 지정된 데이터를 포함합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7, Windows Server 2008 R2 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 헤더 | pmi.h(Pmi.h 포함) |