Funzione ChangerInitialize (mcd.h)
ChangerInitialize legge il modificatore per ricevere altre richieste.
Sintassi
NTSTATUS ChangerInitialize(
[in] PDEVICE_OBJECT DeviceObject
);
Parametri
[in] DeviceObject
Puntatore all'oggetto dispositivo creato dal driver di classe del modificatore per rappresentare questo modificatore.
Valore restituito
ChangerInitialize restituisce il valoreXXX STATUS_ restituito dal driver della porta di sistema o uno dei valori seguenti:
STATUS_SUCCESS
STATUS_INSUFFICIENT_RESOURCES
Osservazioni
Il driver della classe changer chiama ChangerInitialize durante l'inizializzazione del driver, dopo aver creato un oggetto dispositivo per rappresentare un modificatore.
ChangerInitialize esegue qualsiasi elaborazione specifica del dispositivo necessaria per preparare il modificatore a ricevere le richieste. In genere archivia anche informazioni specifiche del dispositivo nell'estensione del dispositivo, ad esempio dati di richiesta SCSI o offset equivalenti non SCSI per generare indirizzi di elementi in base zero, usati dal sistema per fare riferimento agli elementi del modificatore.
Dopo che ChangerInitialize restituisce, il driver miniclasse del modificatore e il modificatore devono essere in grado di gestire qualsiasi altra richiesta.
Fabbisogno
Requisito | Valore |
---|---|
piattaforma di destinazione | Desktop |
intestazione | mcd.h (include Mcd.h, Ntddchgr.h) |
IRQL | PASSIVE_LEVEL |