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
Il valore TRUE indica che questa richiesta di verifica viene eseguita per conto di una richiesta aperta DASD (dispositivo di archiviazione con accesso diretto), che indica che è necessario eseguire 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 ha determinato che il volume non è stato modificato o non è stato montato in precedenza. |
STATUS_INSUFFICIENT_RESOURCES | Risorse di sistema insufficienti per completare l'operazione. |
STATUS_UNSUCCESSFUL | L'operazione di verifica non è riuscita. |
STATUS_WRONG_VOLUME | Il volume è stato modificato. |
Commenti
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 dopo l'ultimo accesso. Un driver del file system chiama in genere IoSetDeviceToVerify e IoVerifyVolume quando il dispositivo inferiore restituisce STATUS_VERIFY_REQUIRED.
Se DeviceObject ha 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 supporti rimovibili, vedere Supporto di supporti rimovibili.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Intestazione | ntifs.h (include Ntifs.h) |
Libreria | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |