Função ChangerClassInitialize (mcd.h)
A rotina ChangerClassInitialize inicializa o driver.
Sintaxe
NTSTATUS ChangerClassInitialize(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPath,
PMCD_INIT_DATA ChangerInitData
);
Parâmetros
[in] DriverObject
Ponteiro para o objeto de driver de miniclasse do alterador. Isso é passado como um parâmetro para a rotina driverEntry do driver de miniclasse. O formato desse objeto é específico do sistema operacional e não deve ser interpretado pelo driver de miniclasse.
[in] RegistryPath
Ponteiro para o caminho do Registro para o driver de miniclasse do alterador. Isso também é passado como um parâmetro para a rotina driverEntry do driver de miniclasse. O formato disso é específico do sistema operacional e não deve ser interpretado pelo driver de miniclasse.
ChangerInitData
Ponteiro para uma estrutura MCD_INIT_DATA que contém informações específicas do driver de miniclasse, como os pontos de entrada para as rotinas de processamento de comando do driver de miniclasse do alterador.
Retornar valor
ChangerClassInitialize retorna um valor que indica o êxito ou a falha da inicialização do driver. Se a inicialização for bem-sucedida, ChangerClassInitialize retornará STATUS_SUCCESS. Caso contrário, ChangerClassInitialize retornará uma mensagem de erro apropriada. Os minidrivers não devem interpretar esse valor de erro, mas devem apenas retornar esse valor de sua rotina driverEntry .
Comentários
ChangerClassInitialize é uma rotina de driver de classe de alteração que os drivers de miniclasse podem chamar no Microsoft Windows XP e em sistemas operacionais posteriores.
Os drivers de miniclasse do changer chamam ChangerClassInitialize de dentro de suas rotinas driverEntry para inicializar o driver. ChangerClassInitialize executa muitas tarefas anteriormente executadas pela rotina DriverEntry do driver de classe do alterador, como registrar as rotinas de expedição do driver de miniclasse. Ele aloca uma extensão de objeto de driver e copia os dados contidos em MCDInitData na extensão de objeto do driver, juntamente com outros dados de inicialização, como o caminho do registro do driver e ponteiros para determinadas rotinas de driver de classe de alterador que são específicas do sistema operacional.
Os drivers de miniclasse do changer devem alocar uma estrutura MCD_INIT_DATA , zero a estrutura chamando RtlZeroMemory e, em seguida, atribuir valores aos membros apropriados, antes de passar o endereço da estrutura para ChangerClassInitialize por meio do parâmetro MCDInitData .
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | mcd.h (include Mcd.h, Ntddchgr.h) |
| Biblioteca | Mcd.lib |