BATTERY_QUERY_INFORMATION 구조체
배터리 쿼리 정보를 포함합니다. 이 구조는 반환할 정보의 형식을 지정하기 위해 IOCTL_BATTERY_QUERY_INFORMATION 제어 코드와 함께 사용됩니다.
구문
typedef struct _BATTERY_QUERY_INFORMATION {
ULONG BatteryTag;
BATTERY_QUERY_INFORMATION_LEVEL InformationLevel;
LONG AtRate;
} BATTERY_QUERY_INFORMATION, *PBATTERY_QUERY_INFORMATION;
멤버
-
BatteryTag
-
배터리의 현재 배터리 태그입니다. 태그와 일치하는 배터리에 대한 정보만 반환할 수 있습니다. 이 값이 배터리의 현재 태그와 일치하지 않을 때마다 IOCTL 요청은 ERROR_FILE_NOT_FOUND 완료됩니다. 이는 태그와 연결된 배터리가 더 오래 있음을 호출자에게 나타냅니다. 호출자는 IOCTL_BATTERY_QUERY_TAG 작업을 사용하여 새로 설치된 배터리의 태그(있는 경우)를 확인하도록 선택할 수 있습니다. 자세한 내용은 배터리 태그를 참조하세요.
쿼리 정보 요청이 수행되면 이 값이 확인됩니다. 또한 이 값이 변경되는 동안 요청이 진행 중인 경우 ERROR_FILE_NOT_FOUND 상태 요청이 중단됩니다.
-
InformationLevel
-
쿼리할 배터리 정보의 수준입니다. IOCTL에서 반환되는 데이터는 이 값에 따라 달라집니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
값 의미 - BatteryDeviceName
- 4
배터리 이름이 포함된 Null로 종료된 유니코드 문자열입니다. - BatteryEstimatedTime
- 3
예상 배터리 실행 시간(초)을 지정하는 ULONG 입니다. BATTERY_QUERY_INFORMATION 구조체의 AtRate 멤버에 제공된 드레이닝 속도가 0인 경우 이 계산은 현재 드레이닝 속도를 기반으로 합니다. AtRate가 0이 아닌 경우 반환되는 시간은 지정된 속도에 대한 예상 실행 시간입니다. 예상 시간을 알 수 없는 경우(예: 배터리가 방전되지 않고 지정된 AtRate 가 0인 경우) 반환 값이 BATTERY_UNKNOWN_TIME. 이 값은 일부 배터리 시스템에서는 매우 정확하지 않으며 디스크 활동 및 기타 요인의 영향을 받을 수 있는 현재 전력 사용량에 따라 크게 달라질 수 있습니다. 이 값의 변경 내용에 대한 알림 메커니즘은 없습니다. - BatteryGranularityInformation
- 1
BATTERY_REPORTING_SCALE 구조체의 배열이며 항목이 4개를 넘지 않습니다. - BatteryInformation
- 0
BATTERY_INFORMATION 구조체입니다. - BatteryManufactureDate
- 5
BATTERY_MANUFACTURE_DATE 구조체입니다. - BatteryManufactureName
- 6
배터리 제조업체의 이름을 지정하는 Null로 종료된 유니코드 문자열입니다. - BatterySerialNumber
- 8
배터리의 일련 번호를 지정하는 Null로 종료된 유니코드 문자열입니다. - BatteryTemperature
- 2
배터리의 현재 온도(10도 켈빈)를 지정하는 ULONG 입니다. - BatteryUniqueID
- 7
배터리를 고유하게 식별하는 Null로 종료된 유니코드 문자열입니다. 이 값은 특정 배터리를 추적하는 데 사용할 수 있습니다. 스마트 배터리의 경우 이 ID는 제조업체 이름, 장치 이름, 제조 날짜 및 일련 번호의 인쇄 가능한 표현의 연결입니다.
이 값은 사용자에게 표시되지 않습니다. -
AtRate
-
이 멤버는 InformationLevel 이 BatteryEstimatedTime인 경우에만 사용됩니다.
이 멤버가 0이 아닌 경우 개별 배터리의 BatteryEstimatedTime에 대해 배터리가 방전될 때까지의 시간을 계산하는 데 사용되는 드레이닝 속도입니다. mW로 지정해야 하며 배터리 방전 속도를 나타내려면 음수 값이어야 합니다.
설명
배터리에 대한 일부 정보는 선택 사항이거나 일부 배터리에 의미가 없을 수 있습니다. 요청된 특정 유형의 데이터를 현재 배터리에 사용할 수 없는 경우 ERROR_INVALID_FUNCTION 반환됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 |
|