Función CcCopyRead (ntifs.h)
El CcCopyRead rutina copia datos de un archivo almacenado en caché en un búfer de usuario.
Sintaxis
BOOLEAN CcCopyRead(
[in] PFILE_OBJECT FileObject,
[in] PLARGE_INTEGER FileOffset,
[in] ULONG Length,
[in] BOOLEAN Wait,
[out] PVOID Buffer,
[out] PIO_STATUS_BLOCK IoStatus
);
Parámetros
[in] FileObject
Puntero a un objeto de archivo para el archivo almacenado en caché desde el que se van a leer 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 leer.
[in] Wait
Establézcalo en TRUE si el autor de la llamada puede colocarse en un estado de espera hasta que se hayan copiado todos los datos, FALSE de lo contrario.
[out] Buffer
Puntero a un búfer en el que se van a copiar los datos.
[out] IoStatus
Puntero a una estructura asignada por el autor de la llamada que recibe el estado de finalización final e información sobre la operación. Si no todos los datos se copian correctamente, ioStatus.Information contiene el número real de bytes que se copiaron.
Valor devuelto
La rutina de CcCopyRead devuelve TRUE si los datos se copiaron correctamente, FALSE de lo contrario.
Observaciones
Si de espera es TRUE, se garantiza CcCopyRead para completar la solicitud de copia y devolver 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 están residentes, el autor de la llamada se pondrá en un estado de espera hasta que se hayan realizado residentes todas las páginas necesarias y se puedan copiar los datos.
Si de espera es FALSE, ccCopyRead se negará a bloquear y devolverá FALSE, si las páginas necesarias del archivo almacenado en caché aún no residen en la memoria.
FileOffset más Longitud debe ser menor o igual que el tamaño del archivo almacenado en caché o se producirá un error de aserción.
Si se produce algún error, ccCopyRead genera una excepción de estado para ese error en particular. Por ejemplo, si se produce un error de asignación de grupo, ccCopyRead genera una excepción de STATUS_INSUFFICIENT_RESOURCES; si se produce un error de E/S, ccCopyRead 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 ccCopyRead en un try-except o instrucción try-finally.
Para almacenar en caché un archivo, use CcInitializeCacheMap.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 |
| de la plataforma de destino de |
Universal |
| encabezado de |
ntifs.h (incluya Ntifs.h, FltKernel.h) |
| biblioteca de |
NtosKrnl.lib |
| DLL de |
NtosKrnl.exe |
| irQL | <= APC_LEVEL |