Função IoVerifyVolume (ntifs.h)
IoVerifyVolume envia uma solicitação de verificação de volume para o dispositivo de mídia removível especificado identificado pelo objeto do dispositivo.
Sintaxe
NTSTATUS IoVerifyVolume(
[in] PDEVICE_OBJECT DeviceObject,
[in] BOOLEAN AllowRawMount
);
Parâmetros
[in] DeviceObject
Ponteiro para uma estrutura DEVICE_OBJECT que identifica o objeto do dispositivo no qual o volume deve ser verificado/montado.
[in] AllowRawMount
Um valor true indica que essa solicitação de verificação está sendo emitida em nome de uma solicitação aberta das DASD (dispositivo de armazenamento de acesso direto), o que indica que uma montagem bruta deve ser executada se a solicitação de verificação falhar.
Retornar valor
IoVerifyVolume retorna o código NTSTATUS da operação de verificação, que pode ser um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | IoVerifyVolume determinou que o volume não foi alterado ou não foi montado anteriormente. |
| STATUS_INSUFFICIENT_RESOURCES | Existem recursos insuficientes do sistema para concluir a operação. |
| STATUS_UNSUCCESSFUL | A operação de verificação não foi bem-sucedida. |
| STATUS_WRONG_VOLUME | O volume foi alterado. |
Comentários
Antes de usar IoSetDeviceToVerify e IoVerifyVolume, os autores de driver devem estudar a maneira como essas rotinas são usadas na amostra FASTFAT.
IoVerifyVolume é chamado para marcar um volume montado no dispositivo especificado quando parece que o volume pode ter sido alterado desde a última vez que foi acessado. Um driver do sistema de arquivos normalmente chama IoSetDeviceToVerify e IoVerifyVolume quando o dispositivo inferior retorna STATUS_VERIFY_REQUIRED.
Se DeviceObject tiver um volume montado, IoVerifyVolume verificará se o volume foi alterado.
Se o volume tiver sido alterado ou não tiver sido montado anteriormente, IoVerifyVolume enviará uma solicitação de montagem de volume para o dispositivo.
Para obter mais informações sobre dispositivos de mídia removível, consulte Suporte à mídia removível.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | ntifs.h (inclua Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |