Función ZwQueryVolumeInformationFile (ntddk.h)
La rutina ZwQueryVolumeInformationFile recupera información sobre el volumen asociado a un archivo, directorio, dispositivo de almacenamiento o volumen determinado.
Sintaxis
NTSYSAPI NTSTATUS ZwQueryVolumeInformationFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID FsInformation,
[in] ULONG Length,
[in] FS_INFORMATION_CLASS FsInformationClass
);
Parámetros
[in] FileHandle
Identificador de un objeto de archivo devuelto por ZwCreateFile o ZwOpenFile para un archivo abierto, directorio, dispositivo de almacenamiento o volumen para el que se solicita información de volumen.
[out] IoStatusBlock
Puntero a una estructura de IO_STATUS_BLOCK que recibe el estado de finalización final e información sobre la operación de consulta. Para llamadas correctas que devuelven datos, se devuelve el número de bytes escritos en el búfer de FsInformation en el miembro Information de la estructura.
[out] FsInformation
Puntero a un búfer asignado por el autor de la llamada que recibe la información deseada sobre el volumen. La estructura de la información devuelta en el búfer se define mediante el parámetro FsInformationClass.
[in] Length
Tamaño en bytes del búfer al que apunta FsInformation. El autor de la llamada debe establecer este parámetro según el FsInformationClass especificado.
[in] FsInformationClass
Tipo de información que se va a devolver sobre el volumen. Establezca este miembro en uno de los siguientes valores de enumeración FS_INFORMATION_CLASS.
Valor | Significado |
---|---|
FileFsAttributeInformation | Devuelve una estructura de FILE_FS_ATTRIBUTE_INFORMATION que contiene información de atributo sobre el sistema de archivos responsable del volumen. |
FileFsControlInformation | Devuelve una estructura de FILE_FS_CONTROL_INFORMATION que contiene información de control del sistema de archivos sobre el volumen. |
FileFsDeviceInformation | Devuelve una estructura de FILE_FS_DEVICE_INFORMATION que contiene información del dispositivo para el volumen. |
FileFsDriverPathInformation | Devuelve una estructura de FILE_FS_DRIVER_PATH_INFORMATION que contiene información sobre si un controlador especificado está en la ruta de acceso de E/S del volumen. El llamador debe almacenar el nombre del controlador en la estructura FILE_FS_DRIVER_PATH_INFORMATION antes de llamar a ZwQueryVolumeInformationFile. |
FileFsFullSizeInformation | Devuelve una estructura de FILE_FS_FULL_SIZE_INFORMATION que contiene información sobre la cantidad total de espacio disponible en el volumen. |
FileFsObjectIdInformation | Devuelve una estructura de FILE_FS_OBJECTID_INFORMATION que contiene información del identificador de objeto específico del sistema de archivos para el volumen. Tenga en cuenta que este no es el mismo que el nombre de volumen único (basado en GUID) asignado por el sistema operativo. |
fileFsSizeInformation | Devuelve una estructura de FILE_FS_SIZE_INFORMATION que contiene información sobre la cantidad de espacio en el volumen que está disponible para el usuario asociado al subproceso que realiza la llamada. |
FileFsVolumeInformation | Devuelve un FILE_FS_VOLUME_INFORMATION que contiene información sobre el volumen, como la etiqueta del volumen, el número de serie y el tiempo de creación. |
FileFsSectorSizeInformation | Devuelve una estructura de FILE_FS_SECTOR_SIZE_INFORMATION que contiene información sobre los tamaños de sector físico y lógico de un volumen. |
Valor devuelto
ZwQueryVolumeInformationFile devuelve STATUS_SUCCESS o un estado de error adecuado.
Observaciones
ZwQueryVolumeInformationFile recupera información sobre el volumen asociado a un archivo, directorio, dispositivo de almacenamiento o volumen determinado.
Si el
ZwQueryVolumeInformationFile devuelve cero en cualquier miembro de una estructura de FILE_XXX_INFORMATION que no sea compatible con el sistema de archivos.
Para obtener información sobre otras rutinas de consulta de información de archivos, vea Objetos de archivo.
Los minifiltros deben usar FltQueryVolumeInformationFile en lugar de ZwQueryVolumeInformationFile.
Los autores de llamadas de ZwQueryVolumeInformationFile deben ejecutarse en IRQL = PASSIVE_LEVEL y con API de kernel especiales habilitadas.
Si la llamada a la función ZwQueryVolumeInformationFile
En el caso de las llamadas desde controladores en modo kernel, las NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de |
Universal |
encabezado de |
ntddk.h (incluya Ntifs.h, Ntddk.h) |
biblioteca de |
NtosKrnl.lib |
DLL de |
NtosKrnl.exe |
irQL | PASSIVE_LEVEL (consulte la sección Comentarios) |
reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |
Consulte también
FILE_FS_DRIVER_PATH_INFORMATION
IRP_MJ_QUERY_VOLUME_INFORMATION
usar versiones Nt y Zw de las rutinas de servicios del sistema nativo