PartyAllocateMemoryCallback

Ein Rückruf, der jedes Mal aufgerufen wird, wenn die Parteibibliothek dynamisch einen neuen Speicherpuffer zuweist.

Syntax

typedef
void* (*PartyAllocateMemoryCallback)(  
    size_t size,  
    uint32_t memoryTypeId  
)  

Parameter

size size_t

Die Größe der Zuteilung, die vorgenommen werden soll. Dieser Wert ist nie 0 (null).

memoryTypeId uint32_t

Ein nicht transparenter Bezeichner, der die interne Speicherkategorie der Parteibibliothek darstellt, die zugewiesen wird. Dieser Wert sollte ignoriert werden.

Rückgabewert

Typ: void*

Ein Zeiger auf einen zugeordneten Speicherblock der angegebenen Größe oder nullptr, wenn die Zuordnung fehlgeschlagen ist.

Hinweise

Dieser Rückruf wird optional mithilfe der Methode PartyManager::SetMemoryCallbacks() installiert.

Der Rückruf muss einen zeiger auf einen zusammenhängenden Speicherblock der angegebenen Größe zuordnen und zurückgeben, der gültig bleibt, bis der entsprechende PartyFreeMemoryCallback des Titels aufgerufen wird, um ihn freizugeben. Wenn dies nicht möglich ist, muss der Rückruf nullptr zurückgeben, damit die Zuordnung fehlschlägt. Speicherbelegungsfehler werden manchmal als harmlos betrachtet, führen aber in der Regel dazu, dass aktuelle Parteibibliotheksvorgänge fehlschlagen.

Jeder Nicht-Nullptr, der von dieser Methode zurückgegeben wird, wird dann an das entsprechende PartyFreeMemoryCallback übergeben, sobald der Arbeitsspeicher nicht mehr benötigt wird.

Anforderungen

Kopfball: Party.h

Weitere Informationen

Party-Mitglieder
PartyFreeMemoryCallback
PartyManager::SetMemoryCallbacks
PartyManager::GetMemoryCallbacks