Funzione IoVerifyVolume (ntifs.h)
IoVerifyVolume invia una richiesta di verifica del volume al dispositivo multimediale rimovibile specificato identificato dall'oggetto dispositivo.
Sintassi
NTSTATUS IoVerifyVolume(
[in] PDEVICE_OBJECT DeviceObject,
[in] BOOLEAN AllowRawMount
);
Parametri
[in] DeviceObject
Puntatore a una struttura DEVICE_OBJECT che identifica l'oggetto dispositivo per il dispositivo in cui deve essere verificato/montato il volume.
[in] AllowRawMount
Un valore TRUE indica che questa richiesta di verifica viene eseguita per conto di una richiesta aperta daSD (dispositivo di archiviazione ad accesso diretto), che indica che deve essere eseguito un montaggio non elaborato se la richiesta di verifica ha esito negativo.
Valore restituito
IoVerifyVolume restituisce il codice NTSTATUS dall'operazione di verifica, che potrebbe essere uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | IoVerifyVolume determinato che il volume non è stato modificato o non è stato montato in precedenza. |
| STATUS_INSUFFICIENT_RESOURCES | Per completare l'operazione esistono risorse di sistema insufficienti. |
| STATUS_UNSUCCESSFUL | L'operazione di verifica non è riuscita. |
| STATUS_WRONG_VOLUME | Il volume è stato modificato. |
Osservazioni
Prima di usare IoSetDeviceToVerify e IoVerifyVolume, i writer di driver devono studiare il modo in cui queste routine vengono usate nell'esempio FASTFAT .
IoVerifyVolume viene chiamato per controllare un volume montato nel dispositivo specificato quando sembra che il volume sia stato modificato dall'ultimo accesso. Un driver del file system chiama in genere IoSetDeviceToVerify e IoVerifyVolume quando il dispositivo inferiore restituisce STATUS_VERIFY_REQUIRED.
Se il DeviceObject dispone di un volume montato, IoVerifyVolume controlla se il volume è stato modificato.
Se il volume è stato modificato o non è stato montato in precedenza, IoVerifyVolume invia una richiesta di montaggio del volume al dispositivo.
Per altre informazioni sui dispositivi rimovibili, vedere Supporto di supporti rimovibili.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ntifs.h (include Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |