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

IAMMediaTypeStream

COM
📘 Microsoft Learn (日本語) · English
IIDab6b4afa-f6e4-11d0-900d-00c04fd9189d継承元IMediaStream自前メソッド開始 vtbl9

公式ドキュメント

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

メソッド 5

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

vtbl 9 HRESULT GetFormat(AM_MEDIA_TYPE* pMediaType, DWORD dwFlags)

注意 このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。GetFormat メソッドはストリームのフォーマットを取得します。

pMediaTypeAM_MEDIA_TYPE*outストリームのフォーマットを受け取る AM_MEDIA_TYPE 構造体へのポインター。
dwFlagsDWORDin予約済み。

戻り値

以下のいずれかの値を返します。

戻り値 説明
MS_E_NOSTREAM
 このオブジェクトに関連付けられたストリームがありません。
S_OK
 成功しました。
vtbl 10 HRESULT SetFormat(AM_MEDIA_TYPE* pMediaType, DWORD dwFlags)

注意 このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。SetFormat メソッドはストリームのフォーマットを設定します。

pMediaTypeAM_MEDIA_TYPE*inストリームのフォーマットを格納した AM_MEDIA_TYPE 構造体へのポインター。
dwFlagsDWORDin予約済み。

戻り値

以下のいずれかの値を返します。

戻り値 説明
MS_E_SAMPLEALLOC
 ストリームは既に別のメディアタイプでサンプルを割り当てています。
S_OK
 成功しました。
vtbl 11 HRESULT CreateSample(INT lSampleSize, BYTE* pbBuffer, DWORD dwFlags, IUnknown* pUnkOuter, IAMMediaTypeSample** ppAMMediaTypeSample)

注意 このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。CreateSample メソッドはストリームサンプルを作成し、必要に応じてサンプルバッファーを指定します。

lSampleSizeINTinサンプルのサイズ。
pbBufferBYTE*in[省略可能] サンプルデータを格納したバイト配列へのポインター、または NULL。
dwFlagsDWORDin予約済み。
pUnkOuterIUnknown*in[省略可能] ストリームサンプルを集約するオブジェクトのインターフェイスへのポインター。
ppAMMediaTypeSampleIAMMediaTypeSample**out作成されたサンプルへのポインターを受け取る IAMMediaTypeSample インターフェイスポインターのアドレス。

戻り値

以下のいずれかの値を返します。

戻り値 説明
E_OUTOFMEMORY
 メモリが不足しています。
E_POINTER
 NULL ポインター引数です。
S_OK
 成功しました。

解説(Remarks)

pUnkOuter が非 NULL の場合、新しいストリームサンプルは指定されたオブジェクトに集約されます。サンプルを受け取るフィルターは、集約するオブジェクトがサポートするインターフェイスをそのサンプルに対してクエリできます。

vtbl 12 HRESULT GetStreamAllocatorRequirements(ALLOCATOR_PROPERTIES* pProps)

注意 このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。GetStreamAllocatorRequirements はストリームのアロケーター要件を取得します。このメソッドは現在実装されていません。

pPropsALLOCATOR_PROPERTIES*outストリームのアロケーター要件を受け取る ALLOCATOR_PROPERTIES 構造体へのポインター。

戻り値

E_FAIL を返します。

vtbl 13 HRESULT SetStreamAllocatorRequirements(ALLOCATOR_PROPERTIES* pProps)

注意 このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。SetStreamAllocatorRequirements はストリームのアロケーター要件を設定します。このメソッドは現在実装されていません。

pPropsALLOCATOR_PROPERTIES*inストリームのアロケーター要件を格納した ALLOCATOR_PROPERTIES 構造体へのポインター。

戻り値

E_FAIL を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAMMediaTypeStream "{AB6B4AFA-F6E4-11D0-900D-00C04FD9189D}"
#usecom global IAMMediaTypeStream IID_IAMMediaTypeStream "{}"
#comfunc global IAMMediaTypeStream_GetFormat                       9 var,int
#comfunc global IAMMediaTypeStream_SetFormat                       10 var,int
#comfunc global IAMMediaTypeStream_CreateSample                    11 int,var,int,sptr,sptr
#comfunc global IAMMediaTypeStream_GetStreamAllocatorRequirements  12 var
#comfunc global IAMMediaTypeStream_SetStreamAllocatorRequirements  13 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。