Función CcCopyWrite (ntifs.h)

La rutina CcCopyWrite copia los datos de un búfer de usuario en un archivo almacenado en caché.

Sintaxis

BOOLEAN CcCopyWrite(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length,
  [in] BOOLEAN        Wait,
  [in] PVOID          Buffer
);

Parámetros

[in] FileObject

Puntero a un objeto de archivo para el archivo almacenado en caché en el que se van a escribir los datos.

[in] FileOffset

Puntero a una variable que especifica el desplazamiento de bytes inicial dentro del archivo almacenado en caché.

[in] Length

Longitud en bytes de los datos que se van a escribir.

[in] Wait

Se establece en TRUE si el autor de la llamada puede colocarse en un estado de espera hasta que se copien todos los datos; de lo contrario, false .

[in] Buffer

Puntero al búfer desde el que se van a copiar los datos.

Valor devuelto

La rutina CcCopyWrite devuelve TRUE si los datos se copiaron correctamente, FALSE de lo contrario.

Comentarios

Si Wait es TRUE, se garantiza que CcCopyWrite complete la solicitud de copia y devuelva TRUE. Si las páginas necesarias del archivo almacenado en caché ya residen en la memoria, los datos se copiarán inmediatamente y no se producirá ningún bloqueo. Si las páginas necesarias no son residentes, el autor de la llamada se colocará en un estado de espera hasta que todas las páginas necesarias se hayan hecho residentes y se puedan copiar los datos.

Si Wait es FALSE, CcCopyWrite se negará a bloquear y devolverá FALSE, si las páginas necesarias del archivo almacenado en caché aún no residen en la memoria o si la marca de FO_WRITE_THROUGH está establecida en el objeto de archivo.

Si se produce algún error, CcCopyWrite genera una excepción de estado para ese error determinado. Por ejemplo, si se produce un error de asignación de grupo, CcCopyWrite genera una excepción de STATUS_INSUFFICIENT_RESOURCES; Si se produce un error de E/S, CcCopyWrite genera la excepción de estado del error de E/S. Por lo tanto, para obtener control si se produce un error, el controlador debe encapsular la llamada a CcCopyWrite en una instrucción try-except o try-finally .

Para almacenar en caché un archivo, use CcInitializeCacheMap.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h, FltKernel.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte también

CcInitializeCacheMap