PMI_CAPABILITIES 구조체(pmi.h)
PMI_CAPABILITIES 구조에는 전력 계량기의 전력 계량 및 예산 기능에 대한 정보가 포함되어 있습니다.
통사론
typedef struct _PMI_CAPABILITIES {
ULONG Version;
ULONG Size;
PMI_CAPABILITIES_TYPE CapabilityType;
union {
PMI_REPORTED_CAPABILITIES ReportedCapabilities;
PMI_METERED_HARDWARE_INFORMATION MeteredHardwareInformation;
} Capabilities;
} PMI_CAPABILITIES, *PPMI_CAPABILITIES;
회원
Version
이 구조체의 버전을 지정하는 값입니다. Windows 7, Windows Server 2008 R2 이상 버전의 Windows의 경우 이 값은 1이어야 합니다.
Size
구조체의 크기를 지정하는 값(바이트 단위)입니다.
CapabilityType
Capabilities 멤버의 데이터 형식을 지정하는 PMI_CAPABILITIES_TYPE 열거형 값입니다.
Capabilities
지원되는 PMI(Power Meter Interface) 기능 구조의 통합입니다. CapabilityType 멤버의 값에 따라 다음 기능 하위 멤버 중 하나가 다음 PMI 기능 구조를 참조하는 데 사용됩니다.
Capabilities.ReportedCapabilities
전원 측정기에서 모니터링되는 하나 이상의 하드웨어 디바이스를 지정하는 PMI_METERED_HARDWARE_INFORMATION 구조체입니다.
Capabilities 멤버는 CapabilityType 멤버가 pmiMeteredHardware 설정된 경우 이 구조를 포함합니다.
Capabilities.MeteredHardwareInformation
다음과 같이 파워 미터의 PMI 기능을 지정하는 PMI_REPORTED_CAPABILITIES 구조체입니다.
- 자산 정보
- 측정 기능
- 전원 및 예산 기능
발언
PMI_CAPABILITIES 구조는 파워 미터에서 지원하는 많은 PMI 기능을 쿼리하는 데 사용됩니다.
PMI 기능 정보는 IOCTL(IOCTL_PMI_GET_CAPABILITIES I/O 컨트롤) 쿼리 요청을 통해 반환됩니다. 이 쿼리 요청에 대한 입력 데이터는 반환할 PMI 기능 데이터의 형식을 지정하는 PMI_CAPABILITIES_TYPE 열거자 값으로 설정됩니다.
IOCTL 쿼리 요청이 성공적으로 완료되면 요청은 PMI_CAPABILITIES 구조를 반환합니다. 이 구조체의 기능 멤버에는 요청된 PMI 기능 구조로 형식이 지정된 데이터가 포함됩니다.
예를 들어 pmiReportedCapabilities 입력 데이터 집합으로 IOCTL_PMI_GET_CAPABILITIES IOCTL 쿼리 요청이 수행되고 요청이 성공적으로 완료되면 요청은 멤버가 다음 값으로 설정된 PMI_CAPABILITIES 구조를 반환합니다.
- CapabilitiesType 멤버는 PmiReportedCapabilities 설정됩니다.
- 기능 멤버는 PMI_REPORTED_CAPABILITIES 구조체로 형식이 지정된 데이터를 포함합니다.
요구 사항
요구 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 7, Windows Server 2008 R2 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
헤더 | pmi.h(Pmi.h 포함) |