Funzione IoGetDeviceAttachmentBaseRef (ntifs.h)

Articolo
02/27/2024

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