Fonction IoVerifyVolume (ntifs.h)

IoVerifyVolume envoie une demande de vérification du volume à l’appareil multimédia amovible spécifié identifié par l’objet d’appareil.

Syntaxe

NTSTATUS IoVerifyVolume(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] BOOLEAN        AllowRawMount
);

Paramètres

[in] DeviceObject

Pointeur vers une structure DEVICE_OBJECT qui identifie l’objet d’appareil pour l’appareil sur lequel le volume doit être vérifié/monté.

[in] AllowRawMount

La valeur TRUE indique que cette demande de vérification est émise pour le compte d’une demande ouverte DASD (périphérique de stockage à accès direct), ce qui indique qu’un montage brut doit être effectué en cas d’échec de la demande de vérification.

Valeur retournée

IoVerifyVolume retourne le code NTSTATUS de l’opération de vérification, qui peut être l’une des valeurs suivantes :

Remarques

Avant d’utiliser IoSetDeviceToVerify et IoVerifyVolume, les rédacteurs de pilotes doivent étudier la façon dont ces routines sont utilisées dans l’exemple FASTFAT.

IoVerifyVolume est appelé à case activée un volume monté sur l’appareil spécifié lorsqu’il apparaît que le volume a peut-être changé depuis son dernier accès. Un pilote de système de fichiers appelle généralement IoSetDeviceToVerify et IoVerifyVolume lorsque l’appareil inférieur retourne STATUS_VERIFY_REQUIRED.

Si deviceObject a un volume monté, IoVerifyVolume vérifie si le volume a changé.

Si le volume a changé ou n’a pas été monté précédemment, IoVerifyVolume envoie une demande de montage de volume à l’appareil.

Pour plus d’informations sur les périphériques multimédias amovibles, consultez Prise en charge des médias amovibles.

Configuration requise

Voir aussi

IoGetDeviceToVerify

IoSetDeviceToVerify