CFP_REALLOCPROC callback function (fontsub.h)

Article
02/22/2024

Client-provided callback function, used by CreateFontPackage and MergeFontPackage to reallocate memory when the size of an allocated buffer needs to change.

Syntax

CFP_REALLOCPROC CfpReallocproc;

void * CfpReallocproc(
  void *unnamedParam1,
  size_t unnamedParam2
)
{...}

Parameters

unnamedParam1

Pointer to previously allocated memory block.

unnamedParam2

New size in bytes.

Return value

Returns a void pointer to the reallocated (and possibly moved) memory block. The return value should be NULL if the size is zero and the memblock argument is not NULL, or if there is not enough available memory to expand the block to the given size. In the first case, the original block should be freed. In the second, the original block should be unchanged.

Remarks

realloc conforms to this type; the application can either use realloc or a more specialized function for memory reallocation. Whatever function is chosen, there must also be appropriate functions for initial allocation and to free this memory.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	fontsub.h