Función CcMapData (ntifs.h)
La rutina CcMapData asigna un intervalo de bytes especificado de un archivo almacenado en caché a un búfer en memoria.
Sintaxis
BOOLEAN CcMapData(
[in] PFILE_OBJECT FileObject,
[in] PLARGE_INTEGER FileOffset,
[in] ULONG Length,
[in] ULONG Flags,
[out] PVOID *Bcb,
[out] PVOID *Buffer
);
Parámetros
[in] FileObject
Puntero a un objeto de archivo para el archivo cuyos datos se van a asignar para el acceso de lectura.
[in] FileOffset
Puntero a una variable que especifica el desplazamiento de bytes inicial dentro del archivo almacenado en caché donde residen los datos deseados.
[in] Length
Longitud de los datos deseados en bytes.
[in] Flags
Máscara de bits de marcas que especifican cómo se va a realizar la operación de asignación. Se trata de una combinación OR bit a bit de uno o varios de los siguientes valores:
Valor | Significado |
---|---|
MAP_WAIT | El autor de la llamada puede colocarse en un estado de espera hasta que se hayan asignado los datos. |
MAP_NO_READ | Solo se asignarán las páginas que ya residen en la memoria. |
Esperar
Establézcalo en TRUE si el autor de la llamada puede colocarse en un estado de espera hasta que se hayan asignado los datos, FALSE de lo contrario.
[out] Bcb
En la primera llamada, devuelve un puntero a una estructura de bloque de control de búfer (BCB). Este puntero debe proporcionarse como entrada en todas las llamadas posteriores, para este búfer.
[out] Buffer
Puntero a un búfer que contiene los datos asignados.
Valor devuelto
ccMapData devuelve TRUE si los datos del archivo almacenado en caché se asignaron correctamente, FALSE de lo contrario.
Observaciones
CcMapData asigna datos en un archivo almacenado en caché para el acceso de lectura. Tenga en cuenta que después de llamar a ccMapData, se asignan los datos; pero no está anclado. Esta distinción es importante. Los datos asignados pero no anclados no se pueden modificar de forma segura. Para anclar los datos, use CcPinMappedData, CcPinReado CcPreparePinWrite.
Cada llamada correcta a ccMapData debe coincidir con una llamada posterior a CcUnpinData.
ccMapData no puede asignar datos a través de límites de vista en el administrador de caché. El administrador de caché administra los archivos del sistema en vistas alineadas con 256 KB. (El tamaño de vista del administrador de caché se especifica mediante la constante definida por el sistema VACB_MAPPING_GRANULARITY, que se establece en 256 KB en ntifs.h). Las regiones asignadas no pueden abarcar más de una vista de 256 KB. Por lo tanto, la región más grande que se puede asignar es de 256 KB, a partir de un desplazamiento alineado con 256 KB en el archivo.
La asignación de un intervalo de bytes en un archivo almacenado en caché no garantiza que las páginas permanezcan residentes en la memoria. Siempre que se asignen las páginas, se garantiza que el intervalo de bytes se mantenga asignado al espacio de direcciones virtuales de caché del sistema, pero el administrador de memoria puede paginar las páginas físicas según requiera la demanda de memoria del sistema.
Si se establece la marca de MAP_WAIT (o espera es TRUE), se garantiza ccMapData para completar la solicitud de asignación y devolver TRUE. Si las páginas necesarias del archivo almacenado en caché ya residen en la memoria, los datos se asignan inmediatamente y no se producirá ningún bloqueo. Si las páginas necesarias no son residentes, el autor de la llamada se coloca en un estado de espera hasta que se hayan realizado residentes todas las páginas necesarias y se puedan asignar los datos. Si la marca MAP_WAIT no está establecida (o wait es FALSE) y los datos no se pueden asignar inmediatamente, CcMapData devuelve FALSE.
El puntero devuelto en buffer es válido hasta que se llama a ccUnpinData. Si se llama a ccPinMappedData mientras este puntero sigue siendo válido, el puntero sigue siendo válido después de la llamada a ccPinMappedData (pero solo hasta que se llama a ccUnpinData).
Si se produce algún error, CcMapData genera una excepción de estado para ese error en particular. Por ejemplo, si se produce un error de asignación de grupo, ccMapData genera una excepción de STATUS_INSUFFICIENT_RESOURCES; si se produce un error de E/S, ccMapData 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 ccMapData en un try-except o instrucción try-finally.
Para almacenar en caché un archivo, use CcInitializeCacheMap.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de |
Universal |
encabezado de |
ntifs.h (incluya Ntifs.h) |
biblioteca de |
NtosKrnl.lib |
DLL de |
NtosKrnl.exe |
irQL | < DISPATCH_LEVEL |
Consulte también
ccPinRead de