語法
參數
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 可能會從不同的執行緒呼叫此回呼,因此請讓它具備執行緒安全。
