Fonction IoGetAttachedDeviceReference (ntifs.h)

  • Article

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 Windows 2000
Plateforme cible Universal
En-tête ntifs.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)

Voir aussi

ObDereferenceObject