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 멤버의 값에 따라 다음 Capabilities 하위 멤버 중 하나가 다음 PMI 기능 구조를 참조하는 데 사용됩니다.

Capabilities.ReportedCapabilities

전원 측정기에서 모니터링되는 하나 이상의 하드웨어 디바이스를 지정하는 PMI_METERED_HARDWARE_INFORMATION 구조체입니다.

CapabilityType 멤버가 PmiMeteredHardware로 설정된 경우 Capabilities 멤버는 이 구조를 포함합니다.

Capabilities.MeteredHardwareInformation

다음과 같이 전원 측정기의 PMI 기능을 지정하는 PMI_REPORTED_CAPABILITIES 구조체입니다.

• 자산 정보
• 측정 기능
• 전원 및 예산 기능

CapabilityType 멤버가 PmiReportedCapabilities로 설정된 경우 Capabilities 멤버는 이 구조를 포함합니다.

설명

PMI_CAPABILITIES 구조는 전원 측정기에서 지원하는 많은 PMI 기능을 쿼리하는 데 사용됩니다.

PMI 기능 정보는 IOCTL(IOCTL_PMI_GET_CAPABILITIES I/O 컨트롤) 쿼리 요청을 통해 반환됩니다. 이 쿼리 요청에 대한 입력 데이터는 반환할 PMI 기능 데이터의 형식을 지정하는 PMI_CAPABILITIES_TYPE 열거자 값으로 설정됩니다.

IOCTL 쿼리 요청이 성공적으로 완료되면 요청은 PMI_CAPABILITIES 구조를 반환합니다. 이 구조체의 Capabilities 멤버에는 요청된 PMI 기능 구조로 형식이 지정된 데이터가 포함됩니다.

예를 들어 입력 데이터를 PmiReportedCapabilities로 설정하여 IOCTL_PMI_GET_CAPABILITIES IOCTL 쿼리 요청이 수행되고 요청이 성공적으로 완료되면 요청은 멤버가 다음 값으로 설정된 PMI_CAPABILITIES 구조를 반환합니다.

• CapabilitiesType 멤버는 PmiReportedCapabilities로 설정됩니다.
• Capabilities 멤버에는 PMI_REPORTED_CAPABILITIES 구조체로 형식이 지정된 데이터가 포함됩니다.

요구 사항

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

추가 정보

IOCTL_PMI_GET_CAPABILITIES

PMI_CAPABILITIES_TYPE

PMI_METERED_HARDWARE_INFORMATION

PMI_REPORTED_CAPABILITIES