Funzione IoGetLowerDeviceObject (ntifs.h)

La routine IoGetLowerDeviceObject restituisce un puntatore all'oggetto dispositivo di livello inferiore successivo nello stack di driver.

Sintassi

PDEVICE_OBJECT IoGetLowerDeviceObject(
  [in] PDEVICE_OBJECT DeviceObject
);

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo nello stack per il quale deve essere restituito l'oggetto dispositivo di livello inferiore successivo.

Valore restituito

IoGetLowerDeviceObject restituisce un puntatore all'oggetto dispositivo di livello inferiore successivo nello stack di driver.

Commenti

Dato un puntatore a un oggetto dispositivo in un file system o in uno stack di driver di dispositivo, IoGetLowerDeviceObject restituisce un puntatore all'oggetto dispositivo di livello inferiore successivo nello stack.

IoGetLowerDeviceObject restituisce NULL se:

• Il driver di livello inferiore successivo non viene caricato.

• Il driver di livello inferiore successivo viene attualmente scaricato, rimosso o eliminato.

• L'oggetto dispositivo a cui punta DeviceObject è l'oggetto dispositivo più basso nello stack di driver.

Un driver di filtro del file system usa in genere IoGetLowerDeviceObject per determinare se è già collegato allo stack di driver di filtro concatenato sopra un determinato oggetto dispositivo del file system. Prima di tutto, il filtro chiama IoGetAttachedDeviceReference per ottenere un puntatore all'oggetto dispositivo più in alto nello stack. Chiama quindi ripetutamente IoGetLowerDeviceObject per esaminare lo stack di driver, controllando ogni oggetto dispositivo per verificare se l'oggetto appartiene al driver di filtro.

IoGetLowerDeviceObject incrementa il conteggio dei riferimenti nell'oggetto dispositivo di livello inferiore successivo, se presente. Ogni chiamata a IoGetLowerDeviceObject che non restituisce NULL deve quindi corrispondere a una chiamata successiva ObDereferenceObject.

Requisiti

Vedi anche

IoGetAttachedDevice

IoGetAttachedDeviceReference

ObDereferenceObject