Funzione IoGetAttachedDevice (ntifs.h)
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ù in alto collegato.
Valore restituito
IoGetAttachedDevice restituisce il dispositivo di livello più alto collegato al dispositivo specificato.
Osservazioni
Se l'oggetto dispositivo specificato da DeviceObject non contiene 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 sull'oggetto dispositivo. Non è quindi necessaria alcuna chiamata corrispondente a ObDereferenceObject.
I chiamanti di IoGetAttachedDevice devono assicurarsi che nessun oggetto dispositivo venga aggiunto o rimosso dallo stack mentre IoGetAttachedDevice è in esecuzione. I chiamanti che non possono eseguire questa operazione devono usare IoGetAttachedDeviceReference.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ntifs.h (include Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |