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ù 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 |