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

Vedi anche

IoGetDeviceToVerify

IoSetDeviceToVerify