BCLASS_SET_INFORMATION_CALLBACK funzione di callback (batclass.h)

BatteryMiniSetInformation richiede che una batteria entri nello stato di ricarica o scarica o imposta un valore di pregiudizio critico per la batteria.

Sintassi

BCLASS_SET_INFORMATION_CALLBACK BclassSetInformationCallback;

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

Parametri

[in] Context

Puntatore all'area di contesto allocata dal driver miniclasse per il dispositivo batteria.

[in] BatteryTag

Valore del tag della batteria restituito in precedenza da BatteryMiniQueryTag.

[in] Level

Uno dei valori seguenti: BatteryCriticalBias, BatteryCharge o BatteryDischarge.

[in] Buffer

La regolazione critica del pregiudizio in milliwatts se Level è BatteryCriticalBias. Non usato per altri valori di Level.

Valore restituito

BatteryMiniSetInformation restituisce uno dei seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Operazione completata.
STATUS_NO_SUCH_DEVICE	Non è presente alcuna batteria.
STATUS_NOT_SUPPORTED	La batteria specificata non supporta l'operazione richiesta.
STATUS_UNSUCCESSFUL	Operazione non riuscita.

Commenti

Il driver della classe batteria chiama BatteryMiniSetInformation per richiedere che una batteria inizi a caricare o scaricare. Può anche chiamare questa routine per impostare un valore di pregiudizio critico.

Con un caricatore/selettore della batteria intelligente, il driver di classe specifica BatteryCharge per selezionare una batteria da caricare, eventualmente interrompendo la ricarica di un'altra batteria.

Il driver di classe specifica BatteryDischarge per indicare quale batteria deve alimentare il sistema.

L'adattamento critico della distorsione è analogo alla capacità di riserva del serbatoio del gas in un'automobile. Rappresenta la carica rimanente quando la capacità della batteria viene segnalata come zero. Anche se il driver di classe non modifica il valore di pregiudizio critico in uso normale, questo campo viene fornito nell'interfaccia come funzionalità di manutenzione. Non tutte le batterie possono mantenere un'impostazione critica di pregiudizio. I driver miniclasse per tali batterie devono restituire STATUS_NOT_SUPPORTED.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	batclass.h (include Batclass.h)
IRQL	PASSIVE_LEVEL