Fonction IoGetAttachedDeviceReference (ntifs.h)
La routine IoGetAttachedDeviceReference retourne un pointeur vers l’objet d’appareil de niveau le plus élevé dans une pile de pilotes et incrémente le nombre de références sur cet objet.
Syntaxe
PDEVICE_OBJECT IoGetAttachedDeviceReference(
[in] PDEVICE_OBJECT DeviceObject
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet d’appareil pour lequel l’objet d’appareil attaché le plus haut est récupéré.
Valeur de retour
IoGetAttachedDeviceReference retourne un pointeur vers l’objet appareil de niveau le plus élevé dans une pile d’objets d’appareil attachés après avoir incrémenté le nombre de références sur l’objet.
Remarques
Si l’objet appareil à DeviceObject n’a pas d’objets d’appareil qui lui sont attachés, DeviceObject et le pointeur retourné est égal.
Les enregistreurs de pilotes de périphérique doivent s’assurer que lorsqu’ils ont terminé toutes les opérations nécessaires pour effectuer cet appel, ils appellent ObDereferenceObject avec le pointeur d’objet de l’appareil retourné par cette routine. L’échec de cette opération empêche le système de libérer ou de supprimer l’objet de l’appareil en raison d’un nombre de références en attente.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| règles de conformité DDI | DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDDIs(storport) |