Win32 API 日本語リファレンス
ホーム › Media.DirectShow › IMemoryData

IMemoryData

COM
📘 Microsoft Learn (日本語) · English
IID327fc560-af60-11d0-8212-00c04fc32c45継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

注意 このインターフェイスは非推奨です。

メソッド 3

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

vtbl 3 HRESULT SetBuffer(DWORD cbSize, BYTE* pbData, DWORD dwFlags)

注意 このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。メモリへのポインターと長さを使用してメモリバッファーを初期化します。

cbSizeDWORDinpbData が指すメモリのサイズ(バイト単位)。
pbDataBYTE*inこのオブジェクトが使用するメモリへのポインター。
dwFlagsDWORDinフラグデータ用に予約されています。ゼロである必要があります。

戻り値

成功した場合は S_OK を返します。cbSize がゼロの場合、または pbData が NULL の場合は E_INVALIDARG を返します。

解説(Remarks)

このメソッドは必要に応じて何度でも呼び出すことができます。IStreamSample::Update を使用してサンプルを非同期に更新する場合は、更新が完了する前に SetBuffer が呼び出されることが決してないようにしてください。

vtbl 4 HRESULT GetInfo(DWORD* pdwLength, BYTE** ppbData, DWORD* pcbActualData)

注意 このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。オーディオデータオブジェクトを記述する情報を取得します。

pdwLengthDWORD*outNULL でない場合、メモリの長さ(バイト単位)。
ppbDataBYTE**outNULL でない場合、メモリへのポインター。
pcbActualDataDWORD*outNULL でない場合、データの長さ(バイト単位)。

戻り値

HRESULT 値を返します。

解説(Remarks)

このメソッドは、SetActual によって最後に設定された、オブジェクトが現在保持しているデータ量を判定します。

vtbl 5 HRESULT SetActual(DWORD cbDataValid)

注意 このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。オブジェクトに現在含まれているオーディオデータの量を設定します。

cbDataValidDWORDinデータの量(バイト単位)。

戻り値

成功した場合は S_OK を返します。必須パラメーターが NULL の場合は E_POINTER を返します。

解説(Remarks)

このメソッドは通常、アプリケーションではなく IAudioMediaStream または IAudioStreamSample オブジェクトによって呼び出されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMemoryData "{327FC560-AF60-11D0-8212-00C04FC32C45}"
#usecom global IMemoryData IID_IMemoryData "{}"
#comfunc global IMemoryData_SetBuffer  3 int,var,int
#comfunc global IMemoryData_GetInfo    4 var,var,var
#comfunc global IMemoryData_SetActual  5 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。