BATTERY_SET_INFORMATION struttura

Contiene informazioni sulla batteria da impostare. Questa struttura viene usata con il codice di controllo IOCTL_BATTERY_SET_INFORMATION .

Sintassi

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

Members

BatteryTag

Tag corrente della batteria. Le informazioni per una batteria corrispondente al tag possono essere restituite solo. Ogni volta che questo valore non corrisponde al tag corrente della batteria, la richiesta IOCTL verrà completata con ERROR_FILE_NOT_FOUND, che indica al chiamante che la batteria per cui ha un tag per non esiste più. Il chiamante può scegliere di usare l'operazione di IOCTL_BATTERY_QUERY_TAG per determinare il tag della batteria appena installata, se presente. Per altre informazioni, vedere Tag batteria .

Quando viene effettuata una richiesta di informazioni sulle query, questo valore viene verificato. Inoltre, se la richiesta è in corso mentre questo valore cambia, la richiesta viene interrotta con lo stato di ERROR_FILE_NOT_FOUND.

InformationLevel

Informazioni sulla batteria da impostare. Il tipo di dati nel membro Buffer dipende dal valore di questo membro. Questo membro può essere uno dei valori seguenti.

Valore	Significato
BatteryCharge 1	Informa il dispositivo della batteria che l'utente ha richiesto che la batteria deve ricaricare in questo momento. Ad esempio, con una batteria intelligente/caricatore/selettore, l'applicazione potrebbe caricare una batteria alla volta. Il membro buffer di questa struttura viene ignorato.
BatteryCriticalBias 0	Imposta la regolazione critica della batteria. Si noti che questo valore non viene normalmente modificato dal software ed è presente nelle interfacce solo come funzionalità di manutenzione. Non tutte le batterie possono mantenere tale impostazione e le informazioni sulla batteria devono essere lette per confermare che la batteria ha accettato l'impostazione.
BatteryDischarge 2	Informa il dispositivo della batteria che l'utente ha richiesto che la batteria venga scaricata in questo momento. Ad esempio, questo potrebbe essere usato per indicare quale batteria l'utente vuole attualmente alimentare il sistema. Il membro buffer di questa struttura viene ignorato.

Buffer

Informazioni sulla batteria da impostare. I dati dipendono dal valore di InformationLevel.

Commenti

La struttura BATTERY_SET_INFORMATION è una struttura a lunghezza variabile e è necessario allocare un buffer di dimensioni appropriate per le informazioni da includere nella struttura.

Requisiti

Vedi anche

IOCTL_BATTERY_SET_INFORMATION