Função BatteryClassInitializeDevice (batclass.h)

Artigo
08/22/2023

A rotina BatteryClassInitializeDevice inicializa um novo dispositivo de bateria para o driver de classe.

Sintaxe

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

Parâmetros

[in] MiniportInfo

Ponteiro para uma estrutura BATTERY_MINIPORT_INFO .

[out] ClassData

Ponteiro para um local no qual BatteryClassInitializeDevice retorna um identificador a ser usado em chamadas subsequentes para rotinas BatteryMiniXxx .

Retornar valor

BatteryClassInitializeDevice retorna STATUS_SUCCESS ou, possivelmente, STATUS_INSUFFICIENT_RESOURCES se não houver memória suficiente disponível para armazenar os dados de miniclasse da bateria.

Comentários

Os drivers de miniclasse de bateria devem chamar BatteryClassInitializeDevice para registrar cada dispositivo de bateria e passar dados sobre o dispositivo e o driver de miniclasse para o driver da classe de bateria.

Essa rotina deve ser chamada como parte da inicialização do dispositivo, normalmente da rotina AddDevice do driver de miniclasse.

O membro Context da estrutura BATTERY_MINIPORT_INFO aponta para uma área em que os drivers de classe e miniclasse mantêm informações sobre o dispositivo de bateria e seus drivers. A área de contexto normalmente contém a extensão de dispositivo paginável do FDO e também pode incluir outras informações a critério do gravador de driver.

O driver de classe passa um ponteiro para a área de contexto em chamadas para rotinas de driver de miniclasse de bateria (rotinas BatteryMiniXxx ). Em suas rotinas BatteryMiniXxx , os drivers de miniclasse devem ler e gravar os dados de extensão do dispositivo por meio do ponteiro passado.

Os drivers de miniclasse devem usar a estrutura BATTERY_MINIPORT_INFO para fornecer pontos de entrada para todas as rotinas BatteryMiniXxx .

Se BatteryClassInitializeDevice inicializar com êxito o dispositivo de bateria, o chamador será responsável por chamar a função BatteryClassUnload para liberar os recursos para o dispositivo de bateria quando ele não estiver mais em uso.