Fonction IoVerifyVolume (ntifs.h)
IoVerifyVolume envoie une demande de vérification du volume à l’appareil amovible spécifié identifié par l’objet de l’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 de 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 d’ouverture 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 de retour
IoVerifyVolume retourne le code NTSTATUS de l’opération de vérification, qui peut être l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | IoVerifyVolume déterminé que le volume n’a pas changé ou n’a pas été monté précédemment. |
| STATUS_INSUFFICIENT_RESOURCES | Des ressources système insuffisantes existent 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 enregistreurs de pilotes doivent étudier la façon dont ces routines sont utilisées dans l’exemple FASTFAT .
IoVerifyVolume est appelée pour vérifier 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 le 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 appareils multimédias amovibles, consultez prise en charge du support multimédia amovible.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |