Fonction IoGetDiskDeviceObject (ntifs.h)
La routine IoGetDiskDeviceObject récupère un pointeur vers l’objet de périphérique de disque associé à un objet de périphérique de volume de système de fichiers donné.
Syntaxe
NTSTATUS IoGetDiskDeviceObject(
[in] PDEVICE_OBJECT FileSystemDeviceObject,
PDEVICE_OBJECT *DiskDeviceObject
);
Paramètres
[in] FileSystemDeviceObject
Pointeur vers l’objet d’appareil de système de fichiers.
DiskDeviceObject
Pointeur vers une variable qui reçoit l’adresse de l’objet d’appareil pour l’objet de périphérique de disque.
Valeur retournée
IoGetDiskDeviceObject retourne l’une des valeurs status suivantes :
| Code de retour | Description |
|---|---|
|
L’un des paramètres passés à cette fonction n’était pas valide. |
|
|
|
Remarques
IoGetDiskDeviceObject retourne un pointeur vers l’objet de périphérique de stockage associé au volume du système de fichiers. Le périphérique de stockage n’a pas besoin d’être un disque réel
Les pilotes de filtre de système de fichiers appellent généralement IoGetDiskDeviceObject pour un objet de périphérique de volume de système de fichiers afin de déterminer si le volume est monté.
IoGetDiskDeviceObject incrémente le nombre de références sur l’objet de périphérique de disque pointé par DeviceObject. Par conséquent, chaque appel réussi à IoGetDiskDeviceObject doit être mis en correspondance par un appel suivant à ObDereferenceObject.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Correctif cumulatif windows 2000 SP4 ; Windows XP |
| Plateforme cible | Universal |
| En-tête | ntifs.h (inclure Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |