ドキュメント

Unity Engine

Unity Engine

IUnityMemoryManager API reference

ネイティブ プラグインで Memory Manager API を使用します。
読み終わるまでの所要時間 7 分最終更新 5日前

このページでは、
IUnityMemoryManager
インターフェースの API リファレンスを提供します。

CreateAllocator

宣言

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**);}

追加リソース