Fonction IoGetAttachedDeviceReference (wdm.h)
La routine IoGetAttachedDeviceReference retourne un pointeur vers l’objet d’appareil de niveau supérieur 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 retournée
IoGetAttachedDeviceReference retourne un pointeur vers l’objet d’appareil de niveau supérieur 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 d’appareil sur DeviceObject n’a aucun objet d’appareil attaché à celui-ci, DeviceObject et le pointeur retourné sont égaux.
Les enregistreurs de pilotes de périphérique doivent s’assurer que lorsqu’ils ont terminé toutes les opérations qui les ont requis pour effectuer cet appel, ils appellent ObDereferenceObject avec le pointeur d’objet d’appareil retourné par cette routine. Si vous ne le faites pas, le système ne peut pas libérer ou supprimer l’objet d’appareil en raison d’un nombre de références en suspens.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Universal |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDDDIs(storport) |