IoGetRelatedDeviceObject, fonction (wdm.h)
Étant donné un objet de 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 de retour
IoGetRelatedDeviceObject retourne un pointeur vers l’objet de l’appareil.
Remarques
Lorsqu’elle est appelée sur un objet de fichier qui représente l’appareil de stockage sous-jacent, IoGetRelatedDeviceObject retourne l’objet d’appareil de niveau le plus élevé dans la pile d’appareils de stockage. Pour obtenir l’objet de périphérique 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 d’appareils de stockage est parcourue au lieu de la pile du système de fichiers.)
Pour vous assurer 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 de fichier. La spécification de FILE_READ_ATTRIBUTES n’entraîne pas le montage du système de fichiers.
L’appelant doit s’exécuter au <IRQL = DISPATCH_LEVEL. En règle générale, les appelants de cette routine s’exécutent à IRQL = PASSIVE_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (voir la section Remarques) |