Funzione IoGetAttachedDeviceReference (ntifs.h)
La routine IoGetAttachedDeviceReference restituisce un puntatore all'oggetto dispositivo di livello più alto in uno stack di driver e incrementa il conteggio dei riferimenti su tale oggetto.
Sintassi
PDEVICE_OBJECT IoGetAttachedDeviceReference(
[in] PDEVICE_OBJECT DeviceObject
);
Parametri
[in] DeviceObject
Puntatore all'oggetto dispositivo per il quale viene recuperato l'oggetto dispositivo più collegato superiore.
Valore restituito
IoGetAttachedDeviceReference restituisce un puntatore all'oggetto dispositivo di livello più alto in uno stack di oggetti dispositivo collegati dopo aver incrementato il conteggio dei riferimenti nell'oggetto.
Commenti
Se l'oggetto dispositivo in DeviceObject non ha oggetti dispositivo collegati, DeviceObject e il puntatore restituito sono uguali.
I writer di driver di dispositivo devono assicurarsi che al termine di tutte le operazioni necessarie per effettuare questa chiamata, che chiamano ObDereferenceObject con il puntatore a oggetti dispositivo restituito da questa routine. In caso contrario, il sistema impedisce al sistema di liberare o eliminare l'oggetto dispositivo a causa di un conteggio dei riferimenti in sospeso.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 |
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDDIs(storport) |