Fonction IoGetRelatedDeviceObject (wdm.h)

Étant donné un objet fichier, la routine IoGetRelatedDeviceObject retourne un pointeur vers l’objet d’appareil correspondant.

Syntaxe

PDEVICE_OBJECT IoGetRelatedDeviceObject(
  [in] PFILE_OBJECT FileObject
);

Paramètres

[in] FileObject

Pointeur vers l’objet fichier.

Valeur retournée

IoGetRelatedDeviceObject retourne un pointeur vers l’objet d’appareil.

Remarques

Lorsqu’il est appelé sur un objet de fichier qui représente le périphérique de stockage sous-jacent, IoGetRelatedDeviceObject retourne l’objet d’appareil de niveau supérieur dans la pile d’appareils de stockage. Pour obtenir l’objet d’appareil de niveau supérieur dans la pile de pilotes du système de fichiers, les pilotes doivent appeler IoGetRelatedDeviceObject sur un objet de fichier qui représente la pile de pilotes du système de fichiers, et le système de fichiers doit actuellement être monté. (Sinon, la pile des périphériques de stockage est parcourue au lieu de la pile du système de fichiers.)

Pour garantir que le système de fichiers est monté sur le périphérique de stockage, le pilote doit avoir spécifié un masque d’accès approprié, tel que FILE_READ_DATA ou FILE_WRITE_ATTRIBUTES, lors de l’ouverture du fichier ou de l’appareil représenté par l’objet fichier. La spécification FILE_READ_ATTRIBUTES n’entraîne pas le montage du système de fichiers.

L’appelant doit être en cours d’exécution à IRQL <= DISPATCH_LEVEL. En règle générale, les appelants de cette routine s’exécutent sur IRQL = PASSIVE_LEVEL.

Configuration requise

Voir aussi

IoGetDeviceObjectPointer