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 in alto.
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 sull'oggetto.
Osservazioni
Se l'oggetto dispositivo in DeviceObject non dispone di oggetti dispositivo collegati, DeviceObject e il puntatore restituito sono uguali.
I writer di driver di dispositivo devono assicurarsi che dopo aver completato 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 impedirà al sistema di liberare o eliminare l'oggetto dispositivo a causa di un conteggio dei riferimenti in sospeso.
Fabbisogno
| 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) |