Fonction IoGetDiskDeviceObject (ntifs.h)

  • Article

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
STATUS_INVALID_PARAMETER
 L’un des paramètres passés à cette fonction n’était pas valide.
STATUS_VOLUME_DISMOUNTED
STATUS_SUCCESS

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

Voir aussi

IoEnumerateDeviceObjectList

IoGetAttachedDevice

IoGetAttachedDeviceReference

IoGetLowerDeviceObject

ObDereferenceObject