ホーム › Media.DirectShow › IAMDevMemoryAllocator

IAMDevMemoryAllocator

COM

IIDc6545bf0-e76b-11d0-bd52-00a0c911ce86継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Note このインターフェイスは AVI Splitter ではサポートされなくなりました。Note このインターフェイスは、AVI ファイルをハードウェアメモリに直接読み込む必要があった古いハードウェアデコーダーをサポートするために定義されました。

メソッド 5

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

vtbl 3 HRESULT GetInfo(DWORD* pdwcbTotalFree, DWORD* pdwcbLargestFree, DWORD* pdwcbTotalMemory, DWORD* pdwcbMinimumChunk)

Note IAMDevMemoryAllocator インターフェイスは非推奨です。メモリの機能に関する情報を取得します。

pdwcbTotalFree	DWORD*	out	空きメモリの合計サイズへのポインター。
pdwcbLargestFree	DWORD*	out	返される最大の空きメモリサイズへのポインター。
pdwcbTotalMemory	DWORD*	out	返される合計メモリサイズへのポインター。
pdwcbMinimumChunk	DWORD*	out	返される最小チャンクサイズへのポインター。粒度とアラインメントの規則を示します。

戻り値

HRESULT 値を返します。

解説(Remarks)

利用可能なメモリの合計量を調べるには、このメソッドを使用します。このメソッドは、そのデバイスで利用可能なオンボードメモリ全体の値を返します。複数のフィルター(デバイス)がメモリを共有している場合は、その特定のデバイスが利用できる量を返します。これはオンボードメモリの合計量の一部である場合があります。この量は実装に依存します。たとえば、コーデックのオンボードメモリマネージャーは、カード上の 32 メガバイト(MB)のメモリすべてにアクセスできる場合があります。しかし、IAMDevMemoryAllocator の個々のピン実装は、このメモリの一部のみを報告します。

vtbl 4 HRESULT CheckMemory(BYTE* pBuffer)

Note IAMDevMemoryAllocator インターフェイスは非推奨です。アロケーターの特定のインスタンス(デバイス)がメモリポインターを割り当てたかどうかをテストします。

pBuffer

BYTE*

割り当てられたメモリバッファーのアドレスへのポインター。

戻り値

オンボードアロケーターがメモリを割り当てた場合は S_OK を、そうでない場合は S_FALSE を返します。特定のデバイス上にあるが割り当てられていないメモリも S_FALSE を返します。

解説(Remarks)

ハードウェアフィルターは通常、ポインターが実際にオンボードメモリを指しているかどうかをテストするために、このメソッドを使用します。

vtbl 5 HRESULT Alloc(BYTE** ppBuffer, DWORD* pdwcbBuffer)

Note IAMDevMemoryAllocator インターフェイスは非推奨です。メモリバッファーを割り当てます。

ppBuffer	BYTE**	out	割り当てられたメモリバッファーのアドレスを受け取るポインター。
pdwcbBuffer	DWORD*	inout	DWORD へのポインター。入力値は割り当てるバイト数、出力値は実際に割り当てられたバイト数です。

戻り値

目的の量のメモリが割り当てられた場合は S_OK を、メモリが利用できなかった場合は S_FALSE を返します。

解説(Remarks)

利用可能なプールからメモリブロックを割り当てるには、このメソッドを呼び出します。

vtbl 6 HRESULT Free(BYTE* pBuffer)

Note IAMDevMemoryAllocator インターフェイスは非推奨です。以前に割り当てられたメモリを解放します。

pBuffer

BYTE*

割り当てられたメモリへのポインター。

戻り値

指定されたアロケーターがメモリを割り当てていない場合(つまり CheckMemory が失敗する場合)は E_INVALIDARG を返します。

解説(Remarks)

このメソッドは、プールからメモリブロックを解放します。

vtbl 7 HRESULT GetDevMemoryObject(IUnknown** ppUnkInnner, IUnknown* pUnkOuter)

Note IAMDevMemoryAllocator インターフェイスは非推奨です。カスタムアロケーターと集約できるデバイスメモリ制御オブジェクトへの IUnknown インターフェイスポインターを取得します。

ppUnkInnner	IUnknown**	out	新しく作成された制御オブジェクト自身の IUnknown へのポインターのアドレス。この内部 IUnknown インターフェイスは、外部オブジェクトが破棄されるときに解放する必要があります。カスタムアロケーターは、このポインターに対して QueryInterface メソッドを呼び出して IAMDevMemoryControl インターフェイスを取得する必要があります。
pUnkOuter	IUnknown*	in	カスタムアロケーター自身の IUnknown インターフェイスへのポインター。このインターフェイスは、カスタムアロケーター内部でデバイスメモリ制御オブジェクトを集約します。

戻り値

HRESULT 値を返します。

解説(Remarks)

デバイスメモリ制御オブジェクトは、カスタムアロケーターと集約するために必要です。オンボードメモリの使用を必要とするレンダラーは、新しいアロケーターを受け取ったときに、メモリが同じデバイスのものであることを確認するために IAMDevMemoryControl をクエリするためです。これは、ハードウェアフィルターが IMemAllocator オブジェクトを受け取り、そのオブジェクトがオンボードメモリを使用する場合と使用しない場合があるために発生します。互換性のあるアロケーターかどうかを判断するために、オブジェクトは特定のメソッドにアクセスするために IAMDevMemoryControl インターフェイスをクエリします。IAMDevMemoryControl は、IAMDevMemoryControl のメソッドを実装する集約オブジェクトを作成します(これらは多くの場合ハードウェア固有です)。

外部オブジェクトが集約を実装する方法の規則については、COM のドキュメントを参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAMDevMemoryAllocator "{C6545BF0-E76B-11D0-BD52-00A0C911CE86}"
#usecom global IAMDevMemoryAllocator IID_IAMDevMemoryAllocator "{}"
#comfunc global IAMDevMemoryAllocator_GetInfo             3 var,var,var,var
#comfunc global IAMDevMemoryAllocator_CheckMemory         4 var
#comfunc global IAMDevMemoryAllocator_Alloc               5 var,var
#comfunc global IAMDevMemoryAllocator_Free                6 var
#comfunc global IAMDevMemoryAllocator_GetDevMemoryObject  7 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IAMDevMemoryAllocator "{C6545BF0-E76B-11D0-BD52-00A0C911CE86}"
#usecom global IAMDevMemoryAllocator IID_IAMDevMemoryAllocator "{}"
#comfunc global IAMDevMemoryAllocator_GetInfo             3 sptr,sptr,sptr,sptr
#comfunc global IAMDevMemoryAllocator_CheckMemory         4 sptr
#comfunc global IAMDevMemoryAllocator_Alloc               5 sptr,sptr
#comfunc global IAMDevMemoryAllocator_Free                6 sptr
#comfunc global IAMDevMemoryAllocator_GetDevMemoryObject  7 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。