Funzione BatteryClassInitializeDevice (batclass.h)

La routine BatteryClassInitializeDevice inizializza un nuovo dispositivo a batteria per il driver di classe.

Sintassi

NTSTATUS BATTERYCLASSAPI BatteryClassInitializeDevice(
  [in]  PBATTERY_MINIPORT_INFO MiniportInfo,
  [out] PVOID                  *ClassData
);

Parametri

[in] MiniportInfo

Puntatore a una struttura BATTERY_MINIPORT_INFO .

[out] ClassData

Puntatore a una posizione in cui BatteryClassInitializeDevice restituisce un handle da usare nelle chiamate successive alle routine BatteryMiniXxx .

Valore restituito

BatteryClassInitializeDevice restituisce STATUS_SUCCESS o, eventualmente, STATUS_INSUFFICIENT_RESOURCES se non è disponibile memoria sufficiente per archiviare i dati della miniclasse della batteria.

Commenti

I driver della miniclasse della batteria devono chiamare BatteryClassInitializeDevice per registrare ogni dispositivo a batteria e per passare i dati sul dispositivo e sul driver miniclasse al driver della classe della batteria.

Questa routine deve essere chiamata come parte dell'inizializzazione del dispositivo, in genere dalla routine AddDevice del driver miniclasse.

Il membro Context della struttura BATTERY_MINIPORT_INFO punta a un'area in cui i driver di classe e miniclasse mantengono informazioni sul dispositivo a batteria e sui relativi driver. L'area di contesto contiene in genere l'estensione del dispositivo visualizzabile dal fdO e può includere anche altre informazioni a discrezione del writer del driver.

Il driver di classe passa un puntatore all'area di contesto nelle chiamate alle routine del driver miniclasse della batteria (routine BatteryMiniXxx ). Nelle routine BatteryMiniXxx i driver miniclasse devono leggere e scrivere i dati dell'estensione del dispositivo tramite il puntatore passato.

I driver miniclass devono utilizzare la struttura BATTERY_MINIPORT_INFO per fornire punti di ingresso per tutte le routine BatteryMiniXxx .

Se BatteryClassInitializeDevice inizializza correttamente il dispositivo della batteria, il chiamante è responsabile della chiamata della funzione BatteryClassUnload per liberare le risorse per il dispositivo a batteria quando non è più in uso.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	batclass.h (include Batclass.h)
Libreria	Battc.lib

Vedi anche

BatteryClassUnload

BatteryMiniDisableStatusNotify

BatteryMiniQueryInformation

BatteryMiniQueryStatus

BatteryMiniQueryTag

BatteryMiniSetInformation

BatteryMiniSetStatusNotify