Función KsQueryInformationFile (ks.h)

La función KsQueryInformationFile realiza una consulta de información en el objeto de archivo especificado. La función intenta usar FastIoDispatch si es posible, o genera una solicitud de información en el objeto de dispositivo.

Sintaxis

KSDDKAPI NTSTATUS KsQueryInformationFile(
  [in]  PFILE_OBJECT           FileObject,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

Parámetros

[in] FileObject

Especifica el objeto de archivo desde el que se va a consultar la información estándar.

[out] FileInformation

Indica el lugar en el que se va a colocar la información del archivo. Se supone que es una dirección válida o sondada.

[in] Length

Especifica la longitud correcta del búfer FileInformation .

[in] FileInformationClass

Especifica la clase de información que se solicita.

Valor devuelto

La función KsQueryInformationFile devuelve STATUS_SUCCESS si se ejecuta correctamente, o si no se realiza correctamente, devuelve un error de consulta.

Comentarios

La función KsQueryInformationFile solo se debe usar en los casos en los que la consulta daría lugar a una solicitud real al controlador subyacente. Por ejemplo, FilePositionInformation no generaría dicha solicitud y no debería usarse. Se supone que el autor de la llamada está serializando el acceso al archivo para las operaciones en un objeto de archivo FO_SYNCHRONOUS_IO.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	ks.h (incluya Ks.h)
Library	Ks.lib