C++ Syntax

bool

MKI_FileWriteInitMemory(

HGLOBAL f_hMemory,

const size_t f_unMemorySize );

Prepares writing to a memory image using an additional, high-performance write cache. This cache will automatically be used by all MKI_FileWrite* procedures.

Parameters

Memory

[HGLOBAL] Handle of allocated global memory. This memory must have been allocated using the GMEM_MOVEABLE attribute.

MemorySize

[size_t] Maximum number of bytes that may be written to the global memory area. This value may be less than the memory area's size.

Return Value

Returns true if the cache has been established successfully, else false (indicating insufficient memory).