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 de 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 ejecuta correctamente, devuelve un error de consulta.

Observaciones

La función KsQueryInformationFile solo debe usarse 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	Valor
de la plataforma de destino de	Universal
encabezado de	ks.h (incluya Ks.h)
biblioteca de	Ks.lib