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 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 montó 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.

Observaciones

Antes de usar IoSetDeviceToVerify y 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 y ioVerifyVolume cuando el dispositivo inferior devuelve STATUS_VERIFY_REQUIRED.

Si el 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 multimedia extraíbles, vea Compatibilidad con medios extraíbles.

Requisitos

Requisito Valor
de la plataforma de destino de Universal
encabezado de ntifs.h (incluya Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL < DISPATCH_LEVEL

Consulte también

ioGetDeviceToVerify

ioSetDeviceToVerify