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
| 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 (voir la section Remarques) |