Funzione ChangerClassInitialize (mcd.h)

  • Articolo

La routine ChangerClassInitialize inizializza il driver.

Sintassi

NTSTATUS ChangerClassInitialize(
  [in] PDRIVER_OBJECT  DriverObject,
  [in] PUNICODE_STRING RegistryPath,
       PMCD_INIT_DATA  ChangerInitData
);

Parametri

[in] DriverObject

Puntatore all'oggetto driver miniclass del modificatore. Viene passato come parametro alla routine DriverEntry del driver miniclasse. Il formato di questo oggetto è specifico del sistema operativo e non deve essere interpretato dal driver miniclasse.

[in] RegistryPath

Puntatore al percorso del Registro di sistema per il driver miniclasse del modificatore. Questo viene passato anche come parametro alla routine DriverEntry del driver miniclasse. Il formato di questo è specifico del sistema operativo e non deve essere interpretato dal driver miniclasse.

ChangerInitData

Puntatore a una struttura MCD_INIT_DATA contenente informazioni specifiche del driver miniclasse, ad esempio i punti di ingresso per le routine di elaborazione dei comandi del driver di miniclasse del modificatore.

Valore restituito

ChangerClassInitialize restituisce un valore che indica l'esito positivo o negativo dell'inizializzazione del driver. Se l'inizializzazione ha esito positivo, ChangerClassInitialize restituisce STATUS_SUCCESS. In caso contrario, ChangerClassInitialize restituisce un messaggio di errore appropriato. I minidriver non devono interpretare questo valore di errore, ma devono semplicemente restituire questo valore dalla routine DriverEntry .

Commenti

ChangerClassInitialize è una routine del driver di classe changer che i driver di miniclasse possono chiamare in Microsoft Windows XP e nei sistemi operativi successivi.

I driver di miniclasse changer chiamano ChangerClassInitialize dalle routine DriverEntry per inizializzare il driver. ChangerClassInitialize esegue molte attività eseguite in precedenza dalla routine DriverEntry del driver della classe changer, ad esempio la registrazione delle routine di invio del driver miniclasse. Alloca un'estensione dell'oggetto driver e copia i dati contenuti in MCDInitData nell'estensione dell'oggetto driver insieme ad altri dati di inizializzazione, ad esempio il percorso del Registro di sistema del driver e i puntatori a determinate routine del driver di classe changer specifiche del sistema operativo.

I driver di miniclasse changer devono allocare una struttura MCD_INIT_DATA , zero la struttura chiamando RtlZeroMemory e quindi assegnare valori ai membri appropriati, prima di passare l'indirizzo della struttura a ChangerClassInitialize tramite il parametro MCDInitData .

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione mcd.h (include Mcd.h, Ntddchgr.h)
Libreria Mcd.lib

Vedi anche

MCD_INIT_DATA

RtlZeroMemory