Función IoVerifyVolume (ntifs.h)
IoVerifyVolume envía una solicitud de comprobación de volumen al dispositivo multimedia extraíble especificado identificado por el objeto de dispositivo.
Sintaxis
NTSTATUS IoVerifyVolume(
[in] PDEVICE_OBJECT DeviceObject,
[in] BOOLEAN AllowRawMount
);
Parámetros
[in] DeviceObject
Puntero a una estructura de DEVICE_OBJECT que identifica el objeto de dispositivo para el dispositivo en el que se va a comprobar o montar el volumen.
[in] AllowRawMount
Un valor de TRUE indica que esta solicitud de comprobación se emite en nombre de una solicitud abierta de DASD (dispositivo de almacenamiento de acceso directo), que indica que se debe realizar un montaje sin procesar si se produce un error en la solicitud de comprobación.
Valor devuelto
IoVerifyVolume devuelve el código NTSTATUS de la operación de comprobación, que podría ser uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | IoVerifyVolume determinó que el volumen no ha cambiado o no se ha montado previamente. |
| STATUS_INSUFFICIENT_RESOURCES | Existen recursos del sistema insuficientes para completar la operación. |
| STATUS_UNSUCCESSFUL | La operación de comprobación no se realizó correctamente. |
| STATUS_WRONG_VOLUME | El volumen ha cambiado. |
Comentarios
Antes de usar IoSetDeviceToVerify e IoVerifyVolume, los escritores de controladores deben estudiar la forma en que se usan estas rutinas en el ejemplo FASTFAT.
Se llama a IoVerifyVolume para comprobar un volumen montado en el dispositivo especificado cuando parezca que el volumen podría haber cambiado desde que se accedió por última vez. Normalmente, un controlador del sistema de archivos llama a IoSetDeviceToVerify e IoVerifyVolume cuando el dispositivo inferior devuelve STATUS_VERIFY_REQUIRED.
Si DeviceObject tiene un volumen montado, IoVerifyVolume comprueba si el volumen ha cambiado.
Si el volumen ha cambiado o no se ha montado anteriormente, IoVerifyVolume envía una solicitud de montaje de volumen al dispositivo.
Para obtener más información sobre los dispositivos de medios extraíbles, vea Compatibilidad con medios extraíbles.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |