PFMultiplayerAllocateMemoryCallback

Ein Rückruf, der jedes Mal aufgerufen wird, wenn ein neuer Speicherpuffer dynamisch von der PlayFab Multiplayer-Bibliothek zugeordnet werden muss.

Syntax

typedef
void* (*PFMultiplayerAllocateMemoryCallback)(  
    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 Kategorie des zugeordneten Arbeitsspeichers der PlayFab Multiplayer-Bibliothek darstellt. 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 PFMultiplayerSetMemoryCallbacks() -Methode 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 PFMultiplayerFreeMemoryCallback 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 die aktuellen Vorgänge der PlayFab Multiplayer-Bibliothek fehlschlagen.

Jeder von dieser Methode zurückgegebene Nicht-Nullptr wird anschließend an den entsprechenden PFMultiplayerFreeMemoryCallback übergeben, sobald der Arbeitsspeicher nicht mehr benötigt wird.

Voraussetzungen

Header: PFMultiplayer.h

Weitere Informationen

PFMultiplayer-Member
PFMultiplayerFreeMemoryCallback
PFMultiplayerSetMemoryCallbacks