Win32 API 日本語リファレンス
ホーム › Devices.Tapi › ITAMMediaFormat

ITAMMediaFormat

COM
📘 Microsoft Learn (日本語) · English
IID0364eb00-4a77-11d1-a671-006097c9a2e8継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ITAMMediaFormat インターフェイス (tapi3ds.h) は、DirectShow のメディア形式を設定および取得します。

メソッド 2

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

vtbl 3 HRESULT get_MediaFormat(AM_MEDIA_TYPE** ppmt)

ITAMMediaFormat::get_MediaFormat メソッド (tapi3ds.h) は、メディア形式を取得します。

ppmtAM_MEDIA_TYPE**outAM_MEDIA_TYPE 構造体の配列へのポインター。AM_MEDIA_TYPE の詳細については、DirectX のドキュメントを参照してください。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

戻り値 説明
S_OK
 メソッドは成功しました。
E_OUTOFMEMORY
 操作を実行するのに十分なメモリがありません。
vtbl 4 HRESULT put_MediaFormat(AM_MEDIA_TYPE* pmt)

ITAMMediaFormat::put_MediaFormat メソッド (tapi3ds.h) は、メディア形式を設定します。

pmtAM_MEDIA_TYPE*inAM_MEDIA_TYPE 構造体へのポインター。AM_MEDIA_TYPE の詳細については、DirectX のドキュメントを参照してください。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

戻り値 説明
S_OK
 メソッドは成功しました。
E_OUTOFMEMORY
 操作を実行するのに十分なメモリがありません。

解説(Remarks)

さまざまな形式がサポートされているアドレス(ほとんどのモデムやボイスボードで使用される Wave MSP アドレスなど)では、この呼び出しは必須であり、これを行わないとターミナルが接続できません。

IP 上に実装されたアドレスなど、その他のアドレスでは、形式が固定されている(あらかじめ決められている)場合があります。その場合、形式があらかじめ決められた形式と一致しないと、この呼び出しは失敗します。そのようにあらかじめ決められた形式を取得するには、アプリケーションは get_MediaFormat を使用できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ITAMMediaFormat "{0364EB00-4A77-11D1-A671-006097C9A2E8}"
#usecom global ITAMMediaFormat IID_ITAMMediaFormat "{}"
#comfunc global ITAMMediaFormat_get_MediaFormat  3 var
#comfunc global ITAMMediaFormat_put_MediaFormat  4 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。