BATTERY_SET_INFORMATION 구조체

설정할 배터리 정보를 포함합니다. 이 구조체는 IOCTL_BATTERY_SET_INFORMATION 제어 코드와 함께 사용됩니다.

구문

typedef struct _BATTERY_SET_INFORMATION {
  ULONG                         BatteryTag;
  BATTERY_SET_INFORMATION_LEVEL InformationLevel;
  UCHAR                         Buffer[1];
} BATTERY_SET_INFORMATION, *PBATTERY_SET_INFORMATION;

멤버

BatteryTag

배터리의 현재 배터리 태그입니다. 태그와 일치하는 배터리 정보는 반환할 수 있습니다. 이 값이 배터리의 현재 태그와 일치하지 않을 때마다 IOCTL 요청은 ERROR_FILE_NOT_FOUND 완료됩니다. 이는 태그가 있는 배터리가 더 이상 존재하지 않음을 호출자에게 나타냅니다. 호출자는 IOCTL_BATTERY_QUERY_TAG 작업을 사용하여 새로 설치된 배터리의 태그(있는 경우)를 확인하도록 선택할 수 있습니다. 자세한 내용은 배터리 태그를 참조하세요.

쿼리 정보 요청이 수행되면 이 값이 확인됩니다. 또한 이 값이 변경되는 동안 요청이 진행 중인 경우 ERROR_FILE_NOT_FOUND 상태 요청이 중단됩니다.

InformationLevel

설정할 배터리 정보입니다. Buffer 멤버의 데이터 형식은 이 멤버의 값에 따라 달라집니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
BatteryCharge 1	사용자가 현재 배터리를 충전해 달라고 요청한 배터리 디바이스에 알릴 수 있습니다. 예를 들어 스마트 배터리/충전기/선택기를 사용하면 애플리케이션에서 한 번에 하나의 배터리를 충전할 수 있습니다. 이 구조체의 Buffer 멤버는 무시됩니다.
BatteryCriticalBias 0	배터리의 중요 바이어스 조정을 설정합니다. 이 값은 일반적으로 소프트웨어에 의해 변경되며 유지 관리 기능으로만 인터페이스에 있다고는 상상되지 않습니다. 모든 배터리가 이러한 설정을 유지할 수 있는 것은 아니며 배터리 정보를 읽어 배터리가 설정을 수락했음을 확인해야 합니다.
BatteryDischarge 2	사용자가 현재 배터리가 방전되도록 요청했음을 배터리 디바이스에 알릴 수 있습니다. 예를 들어 사용자가 현재 시스템에 전원을 공급하려는 배터리를 나타내는 데 사용할 수 있습니다. 이 구조체의 Buffer 멤버는 무시됩니다.

Buffer

설정할 배터리 정보입니다. 데이터는 InformationLevel의 값에 따라 달라집니다.

설명

BATTERY_SET_INFORMATION 구조체는 가변 길이 구조체이며, 구조체에 포함할 정보에 적합한 크기의 버퍼를 할당해야 합니다.

요구 사항

추가 정보

IOCTL_BATTERY_SET_INFORMATION