BCLASS_SET_STATUS_NOTIFY_CALLBACK 콜백 함수(batclass.h)
BatteryMiniSetStatusNotify 는 클래스 드라이버에 알림이 필요한 배터리 용량 및 전원 상태 수준을 설정합니다.
구문
BCLASS_SET_STATUS_NOTIFY_CALLBACK BclassSetStatusNotifyCallback;
NTSTATUS BclassSetStatusNotifyCallback(
[in] PVOID Context,
[in] ULONG BatteryTag,
[in] PBATTERY_NOTIFY BatteryNotify
)
{...}
매개 변수
[in] Context
배터리 디바이스에 대한 미니클래스 드라이버가 할당한 컨텍스트 영역에 대한 포인터입니다.
[in] BatteryTag
이전에 BatteryMiniQueryTag에서 반환한 배터리 태그 값입니다.
[in] BatteryNotify
BATTERY_NOTIFY 구조체에 대한 포인터입니다.
반환 값
BatteryMiniSetStatusNotify 는 다음 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
배터리가 현재 설치되어 있습니다. |
|
배터리가 없거나 지정된 배터리 태그가 잘못되었습니다. |
|
미니클래스 드라이버는 대상 조건을 구분할 수 없습니다. |
설명
배터리 클래스 드라이버는 미니클래스 드라이버의 BatteryMiniSetStatusNotify 루틴을 호출하여 허용되는 배터리 조건 범위에 대한 기준을 설정합니다. 배터리의 용량 또는 전원 상태가 이러한 기준에서 벗어나면 미니클래스 드라이버는 BatteryClassStatusNotify 를 호출하여 클래스 드라이버에 알려야 합니다.
BATTERY_NOTIFY 구조의 PowerState 멤버에서 클래스 드라이버는 하나 이상의 배터리 전원 상태를 지정합니다. 배터리가 PowerState에 없는 전원 상태가 될 때마다 미니클래스 드라이버는 클래스 드라이버에 알려야 합니다.
BATTERY_NOTIFY LowCapacity 및 HighCapacity 멤버에서 클래스 드라이버는 용량 범위를 지정합니다. 용량이 이 범위보다 높거나 낮으면 미니클래스 드라이버가 클래스 드라이버에 알려야 합니다.
일부 배터리는 배터리 클래스 드라이버에서 요청한 정확한 용량을 구분하지 못할 수 있습니다. 가능하면 이러한 배터리의 미니클래스 드라이버는 배터리가 중요한 상태에 접근할 때 사용자에게 알릴 수 있도록 오류를 수정하려고 시도해야 합니다. 그렇지 않으면 이러한 드라이버는 STATUS_NOT_SUPPORTED 반환해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | batclass.h(Batclass.h 포함) |
| IRQL | PASSIVE_LEVEL |