Función KsSetInformationFile (ks.h)

La función KsSetInformationFile realiza un conjunto de información en el objeto de archivo especificado. La función intenta usar FastIoDispatch si es posible, o genera una información establecida en el objeto de dispositivo.

Sintaxis

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

Parámetros

[in] FileObject

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

[in] FileInformation

Indica el lugar en el que se va a colocar la información del archivo. Se supone que la información del archivo 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 establece.

Valor devuelto

La función KsSetInformationFile devuelve STATUS_SUCCESS si se ejecuta correctamente, o si no se realiza correctamente, devuelve un error establecido.

Comentarios

La función KsSetInformationFile solo se debe usar cuando el conjunto daría lugar a una solicitud real al controlador subyacente, no incluidas las operaciones complejas que requieren que se envíen parámetros adicionales al controlador, como el cambio de nombre, la eliminación y la finalización. 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