Funzione ChangerClassInitialize (mcd.h)
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 miniclasse 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. Viene inoltre passato 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 devono non interpretare questo valore di errore, ma devono semplicemente restituire questo valore dalla routine DriverEntry.
Osservazioni
ChangerClassInitialize è una routine del driver di classe del modificatore che i driver miniclasse possono chiamare in Microsoft Windows XP e nei sistemi operativi successivi.
I driver della miniclasse changer chiamano ChangerClassInitialize dall'interno delle routine DriverEntry per inizializzare il driver. ChangerClassInitialize esegue molte attività eseguite in precedenza dalla routine dispatch del driver della classe del modificatore DriverEntry, 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 del modificatore specifiche del sistema operativo specifiche del sistema operativo.
I driver di miniclasse changer devono allocare una struttura MCD_INIT_DATA, zero la struttura chiamando RtlZeroMemorye quindi assegnare valori ai membri appropriati, prima di passare l'indirizzo della struttura a ChangerClassInitialize tramite il parametro MCDInitData.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | mcd.h (include Mcd.h, Ntddchgr.h) |
| libreria | Mcd.lib |