Fonction IoVerifyVolume (ntifs.h)

  • Article

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 :

Code de retour Description
STATUS_SUCCESS IoVerifyVolume a déterminé que le volume n’avait pas changé ou n’était pas monté précédemment.
STATUS_INSUFFICIENT_RESOURCES Les ressources système sont insuffisantes pour terminer l’opération.
STATUS_UNSUCCESSFUL L’opération de vérification a échoué.
STATUS_WRONG_VOLUME Le volume a changé.

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

Condition requise Valeur
Plateforme cible Universal
En-tête ntifs.h (inclure Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Voir aussi

IoGetDeviceToVerify

IoSetDeviceToVerify