Win32 API 日本語リファレンス
ホーム › System.Com › IMalloc

IMalloc

COM
📘 Microsoft Learn (日本語) · English
IID00000002-0000-0000-c000-000000000046継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IMalloc (objidlbase.h) インターフェイスは、メモリの割り当て、解放、および管理を行います。

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 void* Alloc(UINT_PTR cb)
cbUINT_PTRin割り当てるメモリのサイズをバイト単位で指定する。
vtbl 4 void* Realloc(void* pv, UINT_PTR cb)

IMalloc::Realloc (objidlbase.h) メソッドは、以前に割り当てられたメモリブロックのサイズを変更します。

pvvoid*inoptional再割り当てするメモリブロックへのポインター。このパラメーターは、下記の「解説」で説明するとおり NULL にすることができます。
cbUINT_PTRin再割り当てするメモリブロックのサイズ (バイト単位)。このパラメーターは、下記の「解説」で説明するとおり 0 にすることができます。

戻り値

メソッドが成功した場合、戻り値は再割り当てされたメモリブロックへのポインターです。それ以外の場合は NULL です。

解説(Remarks)

このメソッドはメモリブロックを再割り当てしますが、その内容が初期化されることは保証しません。したがって、その後のメモリ初期化は呼び出し側の責任です。割り当てられたブロックは、アラインメントや管理情報のために必要な領域があるため、cb バイトより大きくなる場合があります。

pv 引数はブロックの先頭を指します。pv が NULL の場合、Realloc は IMalloc::Alloc と同じ方法で新しいメモリブロックを割り当てます。pv が NULL でない場合、それは以前の Alloc の呼び出しによって返されたポインターである必要があります。

cb 引数は新しいブロックのサイズ (バイト単位) を指定します。ブロックの内容は、新旧のサイズのうち小さい方までは変更されませんが、新しいブロックは別の場所になることがあります。新しいブロックは別のメモリ位置になることがあるため、Realloc が返すポインターは、pv 引数で渡されたポインターと同じであることは保証されません。pv が NULL でなく、かつ cb が 0 の場合、pv が指すメモリは解放されます。

Realloc は、再割り当てされた (場合によっては移動された) メモリブロックへの void ポインターを返します。サイズが 0 でバッファー引数が NULL でない場合、またはブロックを指定サイズに拡張するのに十分なメモリが利用できない場合、戻り値は NULL になります。前者の場合は元のブロックが解放され、後者の場合は元のブロックは変更されません。

戻り値が指す記憶領域は、任意の型のオブジェクトを格納するのに適切にアラインメントされていることが保証されます。void 以外の型へのポインターを取得するには、戻り値に対して型キャストを使用してください。

vtbl 5 void Free(void* pv)

IMalloc::Free (objidlbase.h) メソッドは、以前に割り当てられたメモリブロックを解放します。

pvvoid*inoptional解放するメモリブロックへのポインター。このパラメーターが NULL の場合、このメソッドは何も行いません。

解説(Remarks)

このメソッドは、IMalloc::Alloc または IMalloc::Realloc の呼び出しによって以前に割り当てられたメモリブロックを解放します。解放されるバイト数は、割り当てられたバイト数と等しくなります。この呼び出しの後、pv が指すメモリブロックは無効になり、以降は使用できません。

vtbl 6 UINT_PTR GetSize(void* pv)

IMalloc::GetSize (objidlbase.h) メソッドは、以前に割り当てられたメモリブロックのサイズを取得します。

pvvoid*inoptionalメモリブロックへのポインター。

戻り値

割り当てられたメモリブロックのサイズ (バイト単位)。pv が NULL ポインターの場合は -1 です。

解説(Remarks)

メモリブロックのサイズ (バイト単位) を取得するには、そのブロックが以前に IMalloc::Alloc または IMalloc::Realloc で割り当てられている必要があります。返されるサイズは実際に割り当てられたサイズであり、割り当て時に要求したサイズより大きい場合があります。

vtbl 7 INT DidAlloc(void* pv)

IMalloc::DidAlloc (objidlbase.h) メソッドは、指定されたメモリブロックの割り当てにこのアロケーターが使用されたかどうかを判定します。

pvvoid*inoptionalメモリブロックへのポインター。このパラメーターが NULL ポインターの場合、-1 が返されます。

戻り値

このメソッドは次の値を返すことがあります。

戻り値 説明
1
 メモリブロックはこのアロケーターによって割り当てられました。
0
 メモリブロックはこのアロケーターによって割り当てられたものではありません。
-1
 このメソッドは、このアロケーターがメモリブロックを割り当てたかどうかを判定できません。
vtbl 8 void HeapMinimize()

IMalloc::HeapMinimize (objidlbase.h) メソッドは、未使用のメモリをオペレーティングシステムに返却することでヒープを最小化します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IMalloc "{00000002-0000-0000-C000-000000000046}"
#usecom global IMalloc IID_IMalloc "{}"
#comfunc global IMalloc_Alloc         3 sptr
#comfunc global IMalloc_Realloc       4 sptr,sptr
#comfunc global IMalloc_Free          5 sptr
#comfunc global IMalloc_GetSize       6 sptr
#comfunc global IMalloc_DidAlloc      7 sptr
#comfunc global IMalloc_HeapMinimize  8
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。