Funzione IoGetDeviceAttachmentBaseRef (ntifs.h)
La routine IoGetDeviceAttachmentBaseRef restituisce un puntatore all'oggetto dispositivo di livello più basso in uno stack di file system o driver di dispositivo.
Sintassi
PDEVICE_OBJECT IoGetDeviceAttachmentBaseRef(
[in] PDEVICE_OBJECT DeviceObject
);
Parametri
[in] DeviceObject
Puntatore a un oggetto dispositivo nello stack.
Valore restituito
IoGetDeviceAttachmentBaseRef restituisce un puntatore all'oggetto dispositivo nella parte inferiore dello stack di driver del file system o del dispositivo. Se l'oggetto dispositivo specificato non è collegato a uno stack di driver, IoGetDeviceAttachmentBaseRef restituisce il puntatore all'oggetto dispositivo in DeviceObject.
Commenti
Un driver di filtro del file system chiama in genere IoGetDeviceAttachmentBaseRef per ottenere l'oggetto dispositivo di livello più basso in uno stack di driver del file system. Spesso questa operazione viene eseguita quando il driver di filtro riceve una notifica che un file system ha registrato o annullato la registrazione come file system attivo. La routine di callback di notifica del driver di filtro chiama IoGetDeviceAttachmentBaseRef per ottenere un puntatore all'oggetto dispositivo di controllo del file system e quindi chiama ObQueryNameString per recuperare il nome di questo oggetto a scopo di debug.
IoGetDeviceAttachmentBaseRef incrementa il conteggio dei riferimenti nell'oggetto dispositivo nella parte inferiore dello stack. Ogni chiamata riuscita a IoGetDeviceAttachmentBaseRef deve quindi corrispondere a una chiamata successiva a ObDereferenceObject.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Aggiornamento cumulativo di Windows 2000 SP4; Windows XP |
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
Vedi anche
IoRegisterFsRegistrationChange