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

Confira também

IoGetDeviceToVerify

IoSetDeviceToVerify