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

ISBE2MediaTypeProfile

COM
IIDf238267d-4671-40d7-997e-25dc32cfed2a継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

メディアタイププロファイルを実装します。

解説(Remarks)

このインターフェイスのインターフェイス識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(ISBE2MediaTypeProfile)

メソッド 4

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

vtbl 3 HRESULT GetStreamCount(DWORD* pCount)

メディアタイププロファイル内のストリーム数を取得します。

pCountDWORD*outプロファイル内のストリーム数を受け取ります。

戻り値

このメソッドは次のいずれかの値を返します。

Return code Description
S_OK
メソッドが成功しました。
E_POINTER
Null ポインターです。
vtbl 4 HRESULT GetStream(DWORD Index, AM_MEDIA_TYPE** ppMediaType)

メディアタイププロファイル内の指定したインデックスに存在するストリームのメディアタイプを取得します。

IndexDWORDinストリームのインデックス。プロファイル内のストリーム数を取得するには、ISBE2MediaTypeProfile::GetStreamCount メソッドを呼び出します。
ppMediaTypeAM_MEDIA_TYPE**outAM_MEDIA_TYPE 構造体へのポインターを受け取ります。呼び出し側は、この構造体を変更したり、割り当てられたメモリを解放したりしてはなりません。

戻り値

このメソッドは次のいずれかの値を返します。

Return code Description
S_OK
メソッドが成功しました。
E_INVALIDARG
パラメーターが無効です。
E_OUTOFMEMORY
メディアタイプポインター用のメモリが不足しています。
E_POINTER
メディアタイプポインターが Null です。
vtbl 5 HRESULT AddStream(AM_MEDIA_TYPE* pMediaType)

メディアタイププロファイルにストリームを追加します。

pMediaTypeAM_MEDIA_TYPE*inプロファイルに追加するストリームのメディアタイプを指定する AM_MEDIA_TYPE 構造体へのポインター。

戻り値

Return code Description
S_OK
メソッドが成功しました。
E_INVALIDARG
パラメーターが無効です。
vtbl 6 HRESULT DeleteStream(DWORD Index)

メディアタイププロファイルからストリームを削除します。

IndexDWORDin削除するストリームのインデックス。プロファイル内のストリーム数を取得するには、ISBE2MediaTypeProfile::GetStreamCount メソッドを呼び出します。

戻り値

このメソッドは次のいずれかの値を返します。

Return code Description
S_OK
メソッドが成功しました。
E_INVALIDARG
パラメーターが無効です。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ISBE2MediaTypeProfile "{F238267D-4671-40D7-997E-25DC32CFED2A}"
#usecom global ISBE2MediaTypeProfile IID_ISBE2MediaTypeProfile "{}"
#comfunc global ISBE2MediaTypeProfile_GetStreamCount  3 var
#comfunc global ISBE2MediaTypeProfile_GetStream       4 int,var
#comfunc global ISBE2MediaTypeProfile_AddStream       5 var
#comfunc global ISBE2MediaTypeProfile_DeleteStream    6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。