Sintaxe
Parâmetros
size _In_ size_t
O tamanho, em bytes, da alocação a ser feita. Esse valor nunca é zero.
memoryTypeId _In_ uint32_t
Um identificador opaco da categoria interna da memória que está sendo alocada. Ignore esse valor.
Valor de retorno
Tipo: void* Um ponteiro para um bloco de memória alocado do tamanho especificado ounullptr se a alocação falhar. O cabeçalho anota o valor de retorno com _Ret_maybenull_ e _Post_writable_byte_size_(size).
Comentários
Para instalar esse retorno de chamada, defina-o no membroalloc de uma estrutura PFMemoryHooks e passe a estrutura para PFMemSetFunctions antes de chamar PFInitialize. Defina ao mesmo tempo o membro free como um retorno de chamada PFMemFreeFunction correspondente. PFMemSetFunctions retorna E_INVALIDARG se apenas um dos dois membros estiver definido.
O retorno de chamada deve retornar um ponteiro para um bloco contíguo de memória do tamanho solicitado. O bloco deve permanecer válido até que o PlayFab o passe para o seu retorno de chamada PFMemFreeFunction. O PlayFab passa todos os ponteiros não nulos que esse retorno de chamada retorna para o seu retorno de chamada PFMemFreeFunction quando não precisa mais da memória.
Se a libHttpClient ainda não estiver inicializada quando você chamar PFMemSetFunctions, o PlayFab também instalará ganchos que roteiam as alocações da libHttpClient por meio desse retorno de chamada.
Para obter os ganchos em uso no momento, incluindo os ganchos padrão, chame PFMemGetFunctions.
O PlayFab pode chamar esse retorno de chamada de threads diferentes, portanto, torne-o thread-safe.