IUnityMemoryManager API reference
ネイティブ プラグインで Memory Manager API を使用します。
読み終わるまでの所要時間 7 分最終更新 5日前
このページでは、 インターフェースの API リファレンスを提供します。
IUnityMemoryManagerCreateAllocator
宣言
UnityAllocator* (UNITY_INTERFACE_API * CreateAllocator)(const char* areaName, const char* objectName);パラメーター
パラメーター | 説明 |
|---|---|
| const char areaName* | このアロケーターの幅広いカテゴリの名前。 |
| const char objectName* | この特定のアロケーターの名前。 |
説明
メモリブロックを割り当てることができる新しいアロケーターオブジェクトを作成します。
DestroyAllocator
宣言
void(UNITY_INTERFACE_API * DestroyAllocator)(UnityAllocator * allocator);パラメーター
パラメーター | 説明 |
|---|---|
| UnityAllocator * allocator | 削除するアロケーター。 |
説明
既存のアロケーターオブジェクトを削除します。
割り当て
宣言
void* (UNITY_INTERFACE_API * Allocate)(UnityAllocator * allocator, size_t size, size_t align, const char* file, int32_t line);パラメーター
パラメーター | 説明 |
|---|---|
| UnityAllocator * allocator | アロケーションに使用するアロケーター。 |
| size_t size | 割り当てるメモリ量 (バイト単位)。 |
| size_t align | 結果ポインタのメモリアドレスの整列 |
| const char file* | このアロケーションを行うコールのソース ファイルへのパス。ここで定義済みマクロ FILE を使用します。 |
| int32_t line | このアロケーションを行うコールのソース ファイル内の行番号。ここで定義済みマクロ LINE を使用します。 |
説明
既存のアロケーターを使用してメモリ ブロックを割り当てます。このメソッドは、新しく割り当てられたメモリへのポインターを返します。
割り当て解除
宣言
void(UNITY_INTERFACE_API * Deallocate)(UnityAllocator * allocator, void* ptr, const char* file, int32_t line);パラメーター
パラメーター | 説明 |
|---|---|
| UnityAllocator * allocator | 割り当て解除に使用するアロケーター。 |
| void ptr* | 割り当て解除するメモリへのポインター |
| const char file* | この割り当て解除を行うコール元のソースファイルへのパス。ここで定義済みマクロ FILE を使用します。 |
| int32_t line | この割り当て解除を行うコールが発生したソースファイルの行番号。ここで定義済みマクロ LINE を使用します。 |
説明
指定したポインターが指すメモリの割り当てを解除します。ポインタは null に設定されません。
再割り当て
宣言
void* (UNITY_INTERFACE_API * Reallocate)(UnityAllocator * allocator, void* ptr, size_t size, size_t align, const char* file, int32_t line);パラメーター
パラメーター | 説明 |
|---|---|
| UnityAllocator * allocator | 再割り当て操作に使用するアロケーター。 |
| void ptr* | 割り当て解除するメモリへのポインター |
| size_t size | 割り当てるメモリ量 (バイト単位)。 |
| size_t align | 結果ポインタのメモリアドレスの整列 |
| const char file* | この再割り当てを行うコール元のソースファイルへのパス。ここで定義済みマクロ FILE を使用します。 |
| int32_t line | この再割り当てを行うコールが行われたソースファイルの行番号。ここで定義済みマクロ LINE を使用します。 |
説明
既存のポインターを別のメモリブロックを指すように再割り当てします。
実装例
以下は、 インターフェースの実装例です。
IUnityMemoryManager#include "IUnityInterface.h"#include "IUnityMemoryManager.h"#include <cstdint>static IUnityMemoryManager* s_MemoryManager = NULL;static UnityAllocator* s_Alloc = NULL;extern "C" void Unity_インターフェース_エクスポート Unity_インターフェース_API UnityPluginLoad(IUnityInterfaces * unityInterfaces){ s_MemoryManager = unityInterfaces->Get<IUnityMemoryManager>(); if (s_MemoryManager == NULL) return; // Create an allocator.これにより、スナップショット作成時にプロファイラーでアロケーションルートを確認できます。プラグインネイティブ - プラグインバックエンドアロケーターの下 // All memory allocated here also goes under kMemNativePlugin s_Alloc = s_MemoryManager->CreateAllocator("plug-ins-native", "Plugin Backend Allocator");}extern "C" void UNITY_INTERFACE_EXPORT UNITY_INTERFACE_API UnityPluginUnload(){ //Free allocator s_MemoryManager->DestroyAllocator(s_Alloc); s_Alloc = NULL; s_MemoryManager = NULL;}void DoMemoryOperations(){ // Allocate 1KB memory void* mem = s_MemoryManager->Allocate(s_Alloc, 1 * 1024, 16, __FILE__, __LINE__); // Reallocate the same pointer with 2KB mem = s_MemManager->Reallocate(s_Alloc, mem, 2 * 1024, 16, __FILE__, __LINE__); // Delete allocated memory s_MemoryManager->Deallocate(s_Alloc, mem, **FILE**, **LINE**);}