Función IoVerifyVolume (ntifs.h)

  • Artículo

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

Consulte también

IoGetDeviceToVerify

IoSetDeviceToVerify