跳轉到主要內容
PlayFab 每次需要動態配置記憶體緩衝區時所呼叫的回呼。

語法

參數

size   _In_ size_t 要配置的大小 (以位元組為單位)。此值絕不會是零。 memoryTypeId   _In_ uint32_t 所配置記憶體之內部類別的不透明識別碼。請忽略此值。

傳回值

類型:void* 指向已配置之指定大小記憶體區塊的指標;如果配置失敗,則為 nullptr。標頭會以 _Ret_maybenull_ 和 _Post_writable_byte_size_(size) 標註傳回值。

備註

若要安裝此回呼,請在 PFMemoryHooks 結構的 alloc 成員中設定它,並在呼叫 PFInitialize 之前,將該結構傳遞給 PFMemSetFunctions。同時將 free 成員設定為對應的 PFMemFreeFunction 回呼。如果只設定這兩個成員之一,PFMemSetFunctions 會傳回 E_INVALIDARG。 此回呼必須傳回指向所要求大小之連續記憶體區塊的指標。在 PlayFab 將該區塊傳遞給您的 PFMemFreeFunction 回呼之前,區塊必須保持有效。當 PlayFab 不再需要記憶體時,會將此回呼傳回的每個非 Null 指標傳遞給您的 PFMemFreeFunction 回呼。 如果您呼叫 PFMemSetFunctions 時 libHttpClient 尚未初始化,PlayFab 也會安裝攔截,將 libHttpClient 的配置路由至此回呼。 若要取得目前使用中的攔截 (包括預設攔截),請呼叫 PFMemGetFunctions。 PlayFab 可能會從不同的執行緒呼叫此回呼,因此請讓它具備執行緒安全。

需求

標頭: PFPlatform.h 程式庫: PlayFabCore.lib 支援的平台: Windows、XBOX One 系列主機與 XBOX Series 主機

另請參閱

PFPlatform 成員 PFMemoryHooks PFMemFreeFunction
最後修改於 2026年11月5日