Fonction IoGetDiskDeviceObject (ntifs.h)
La routine IoGetDiskDeviceObject récupère un pointeur vers l’objet d’appareil de disque associé à un objet d’appareil 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 du système de fichiers.
DiskDeviceObject
Pointeur vers une variable qui reçoit l’adresse de l’objet d’appareil pour l’objet d’appareil disque.
Valeur de retour
IoGetDiskDeviceObject retourne l’une des valeurs d’état suivantes :
| Retourner le code | 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. L’appareil 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 d’appareil de volume de système de fichiers pour déterminer si le volume est monté.
IoGetDiskDeviceObject incrémente le nombre de références sur l’objet d’appareil disque pointé par DeviceObject. Ainsi, chaque appel réussi à IoGetDiskDeviceObject doit être mis en correspondance par un appel ultérieur à ObDereferenceObject.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Correctif cumulatif windows 2000 SP4 ; Windows XP |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |