Funzione IoGetAttachedDevice (ntifs.h)

  • Articolo

La routine IoGetAttachedDevice restituisce un puntatore all'oggetto dispositivo di livello più alto associato al dispositivo specificato.

Sintassi

PDEVICE_OBJECT IoGetAttachedDevice(
  [in] PDEVICE_OBJECT DeviceObject
);

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo per il quale deve essere restituito il dispositivo più collegato in alto.

Valore restituito

IoGetAttachedDevice restituisce il dispositivo di livello più alto collegato al dispositivo specificato.

Commenti

Se l'oggetto dispositivo specificato da DeviceObject non ha altri oggetti dispositivo collegati, DeviceObject e il puntatore restituito sono uguali.

IoGetAttachedDevice differisce da IoGetAttachedDeviceReference nei seguenti aspetti:

  • IoGetAttachedDevice non incrementa il conteggio dei riferimenti nell'oggetto dispositivo. Pertanto non è necessaria alcuna chiamata corrispondente a ObDereferenceObject .

  • I chiamanti di IoGetAttachedDevice devono assicurarsi che nessun oggetto dispositivo venga aggiunto o rimosso dallo stack durante l'esecuzione di IoGetAttachedDevice . I chiamanti che non possono eseguire questa operazione devono usare invece IoGetAttachedDeviceReference .

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Vedi anche

IoGetAttachedDeviceReference

ObDereferenceObject