Funzione IoGetDeviceAttachmentBaseRef (ntifs.h)

2025-02-07

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 del file system o del driver di dispositivo. Se l'oggetto dispositivo specificato non è collegato a uno stack di driver, IoGetDeviceAttachmentBaseRef restituisce il puntatore dell'oggetto dispositivo in DeviceObject.

Osservazioni

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 dell'oggetto a scopo di debug.

IoGetDeviceAttachmentBaseRef incrementa il conteggio dei riferimenti nell'oggetto dispositivo nella parte inferiore dello stack. Pertanto, ogni chiamata riuscita a IoGetDeviceAttachmentBaseRef deve essere confrontata con una chiamata successiva a ObDereferenceObject.

Fabbisogno

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