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.
NTSTATUS IoVerifyVolume(
[in] PDEVICE_OBJECT DeviceObject,
[in] BOOLEAN AllowRawMount
);
[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.
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. |
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.
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 |