IoGetLowerDeviceObject, fonction (ntifs. h)

La routine IoGetLowerDeviceObject retourne un pointeur vers l’objet appareil suivant de niveau inférieur sur la pile de pilotes.

Syntaxe

PDEVICE_OBJECT IoGetLowerDeviceObject(
  [in] PDEVICE_OBJECT DeviceObject
);

Paramètres

[in] DeviceObject

Pointeur vers l’objet périphérique dans la pile pour lequel l’objet périphérique de niveau inférieur suivant doit être retourné.

Valeur de retour

IoGetLowerDeviceObject retourne un pointeur vers l’objet appareil suivant de niveau inférieur sur la pile de pilotes.

Notes

Dans le cas d’un pointeur vers un objet périphérique dans un système de fichiers ou une pile de pilotes de périphériques, IoGetLowerDeviceObject retourne un pointeur vers l’objet périphérique de niveau inférieur suivant sur la pile.

IoGetLowerDeviceObject retourne la valeur null si :

  • Le pilote suivant de niveau inférieur n’est pas chargé.
  • Le pilote suivant de niveau inférieur est actuellement déchargé, supprimé ou supprimé.
  • L’objet périphérique pointé par deviceobject est l’objet périphérique le plus bas dans la pile de pilotes.
Un pilote de filtre de système de fichiers utilise généralement IoGetLowerDeviceObject pour déterminer s’il est déjà attaché à la pile de pilotes de filtre qui est chaînée au-dessus d’un objet d’appareil de système de fichiers donné. Tout d’abord, le filtre appelle IoGetAttachedDeviceReference pour obtenir un pointeur vers l’objet d’appareil le plus haut dans la pile. Elle appelle ensuite IoGetLowerDeviceObject à plusieurs reprises pour parcourir la pile de pilotes, en vérifiant chaque objet d’appareil pour déterminer si l’objet appartient au pilote de filtre.

IoGetLowerDeviceObject incrémente le décompte de références sur l’objet Device suivant de niveau inférieur. Par conséquent, chaque appel réussi à IoGetLowerDeviceObject doit être mis en correspondance par un ObDereferenceObjectd’appel suivant.

Spécifications

   
Client minimal pris en charge cette routine est disponible sur le correctif cumulatif pour Windows 2000 Service Pack 4 (SP4) et sur Windows XP et versions ultérieures.
Plateforme cible Universal
En-tête ntifs. h (inclure Ntifs. h)
Bibliothèque NtosKrnl. lib
DLL NtosKrnl.exe
NIVEAU <= DISPATCH_LEVEL

Voir aussi

IoGetAttachedDevice

IoGetAttachedDeviceReference

ObDereferenceObject