다음을 통해 공유

BCLASS_SET_INFORMATION_CALLBACK 콜백 함수(batclass.h)

  • 아티클

BatteryMiniSetInformation 은 배터리가 충전 또는 방전 상태가 되도록 요청하거나 배터리에 대한 중요한 바이어스 값을 설정합니다.

구문

BCLASS_SET_INFORMATION_CALLBACK BclassSetInformationCallback;

NTSTATUS BclassSetInformationCallback(
  [in] PVOID Context,
  [in] ULONG BatteryTag,
  [in] BATTERY_SET_INFORMATION_LEVEL Level,
  [in] PVOID Buffer
)
{...}

매개 변수

[in] Context

배터리 디바이스의 미니클래스 드라이버에서 할당한 컨텍스트 영역에 대한 포인터입니다.

[in] BatteryTag

BatteryMiniQueryTag에서 이전에 반환한 배터리 태그 값입니다.

[in] Level

BatteryCriticalBias, BatteryCharge 또는 BatteryDischarge 값 중 하나입니다.

[in] Buffer

Level이 BatteryCriticalBias인 경우 밀리와트의 중요한 바이어스 조정입니다. Level의 다른 값에는 사용되지 않습니다.

반환 값

BatteryMiniSetInformation 은 다음 중 하나를 반환합니다.

반환 코드 설명
STATUS_SUCCESS
 작업에 성공했습니다.
STATUS_NO_SUCH_DEVICE
 배터리가 없습니다.
STATUS_NOT_SUPPORTED
 지정된 배터리가 요청된 작업을 지원하지 않습니다.
STATUS_UNSUCCESSFUL
 작업이 실패했습니다.

설명

배터리 클래스 드라이버는 BatteryMiniSetInformation 을 호출하여 배터리 충전 또는 방전 시작을 요청합니다. 이 루틴을 호출하여 중요한 바이어스 값을 설정할 수도 있습니다.

스마트 배터리 충전기/선택기를 사용하여 클래스 드라이버는 충전할 배터리를 선택하도록 BatteryCharge 를 지정하여 다른 배터리의 충전을 중단할 수 있습니다.

클래스 드라이버는 시스템에 전원을 공급해야 하는 배터리를 나타내기 위해 BatteryDischarge 를 지정합니다.

중요한 바이어스 조정은 자동차에서 가스 탱크의 예비 용량과 유사합니다. 배터리 용량이 0으로 보고되는 경우 남은 충전을 나타냅니다. 클래스 드라이버는 일반적으로 중요한 바이어스 값을 변경하지 않지만 이 필드는 인터페이스에서 유지 관리 기능으로 제공됩니다. 모든 배터리가 중요한 바이어스 설정을 유지할 수 있는 것은 아닙니다. 이러한 배터리에 대한 미니 클래스 드라이버는 STATUS_NOT_SUPPORTED 반환해야합니다.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 batclass.h(Batclass.h 포함)
IRQL PASSIVE_LEVEL