ホーム › Media.DirectShow › IBDA_Encoder
IBDA_Encoder
COM公式ドキュメント
デバイスのエンコーダーサービスへのアクセスを提供します。
解説(Remarks)
このインターフェイスのインターフェイス識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(IBDA_Encoder)。
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
デバイスがサポートするエンコード形式の数を取得します。
| NumAudioFmts | DWORD* | out | オーディオ形式の数を受け取ります。 |
| NumVideoFmts | DWORD* | out | ビデオ形式の数を受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
vtbl 4 HRESULT EnumAudioCapability(DWORD FmtIndex, DWORD* MethodID, DWORD* AlgorithmType, DWORD* SamplingRate, DWORD* BitDepth, DWORD* NumChannels)
デバイスがサポートするオーディオ形式のうち 1 つを取得します。
| FmtIndex | DWORD | in | 取得するオーディオ形式の 0 から始まるインデックス。オーディオ形式の数を取得するには、IBDA_Encoder::QueryCapabilities を呼び出します。 | ||||||
| MethodID | DWORD* | out | このオーディオメソッドを一意に識別する値を受け取ります。 | ||||||
| AlgorithmType | DWORD* | out | エンコードアルゴリズムの種類を受け取ります。次の値が定義されています。
| ||||||
| SamplingRate | DWORD* | out | オーディオのサンプリングレート (Hz 単位) を受け取ります。 | ||||||
| BitDepth | DWORD* | out | オーディオサンプルあたりのビット数を受け取ります。 | ||||||
| NumChannels | DWORD* | out | オーディオチャンネルの数を受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
vtbl 5 HRESULT EnumVideoCapability(DWORD FmtIndex, DWORD* MethodID, DWORD* AlgorithmType, DWORD* VerticalSize, DWORD* HorizontalSize, DWORD* AspectRatio, DWORD* FrameRateCode, DWORD* ProgressiveSequence)
デバイスがサポートするビデオ形式のうち 1 つを取得します。
| FmtIndex | DWORD | in | 取得するビデオ形式の 0 から始まるインデックス。ビデオ形式の数を取得するには、IBDA_Encoder::QueryCapabilities を呼び出します。 |
| MethodID | DWORD* | out | このビデオメソッドを一意に識別する値を受け取ります。 |
| AlgorithmType | DWORD* | out | エンコードアルゴリズムの種類を受け取ります。次の値が定義されています。 |
| VerticalSize | DWORD* | out | vertical_size_value フィールドを受け取ります。 |
| HorizontalSize | DWORD* | out | horizontal_size_value フィールドを受け取ります。 |
| AspectRatio | DWORD* | out | aspect_ratio_information フィールドを受け取ります。 |
| FrameRateCode | DWORD* | out | frame_rate_code フィールドを受け取ります。 |
| ProgressiveSequence | DWORD* | out | progressive_sequence フィールドを受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
VerticalSize、HorizontalSize、AspectRatio、FrameRateCode、ProgressiveSequence の各パラメーターは、ANSI/SCTE 43 2005 標準に従って解釈されます。
vtbl 6 HRESULT SetParameters(DWORD AudioBitrateMode, DWORD AudioBitrate, DWORD AudioMethodID, DWORD AudioProgram, DWORD VideoBitrateMode, DWORD VideoBitrate, DWORD VideoMethodID)
エンコーダーサービスのパラメーターを設定します。
| AudioBitrateMode | DWORD | in | オーディオ圧縮モード。次の値が定義されています。
| ||||||||
| AudioBitrate | DWORD | in | オーディオビットレート。 | ||||||||
| AudioMethodID | DWORD | in | 有効なオーディオエンコーダーメソッド。 | ||||||||
| AudioProgram | DWORD | in | オーディオのプログラム番号。 | ||||||||
| VideoBitrateMode | DWORD | in | ビデオ圧縮モード。値の一覧については、AudioBitrateMode を参照してください。 | ||||||||
| VideoBitrate | DWORD | in | ビデオビットレート。 | ||||||||
| VideoMethodID | DWORD | in | 有効なビデオエンコーダーメソッド。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
vtbl 7 HRESULT GetState(DWORD* AudioBitrateMax, DWORD* AudioBitrateMin, DWORD* AudioBitrateMode, DWORD* AudioBitrateStepping, DWORD* AudioBitrate, DWORD* AudioMethodID, DWORD* AvailableAudioPrograms, DWORD* AudioProgram, DWORD* VideoBitrateMax, DWORD* VideoBitrateMin, DWORD* VideoBitrateMode, DWORD* VideoBitrate, DWORD* VideoBitrateStepping, DWORD* VideoMethodID, DWORD* SignalSourceID, ULONGLONG* SignalFormat, BOOL* SignalLock, INT* SignalLevel, DWORD* SignalToNoiseRatio)
エンコーダーサービスの現在の状態を照会します。
| AudioBitrateMax | DWORD* | out | オーディオビットレートの最大値を受け取ります。 | ||||||||
| AudioBitrateMin | DWORD* | out | オーディオビットレートの最小値を受け取ります。 | ||||||||
| AudioBitrateMode | DWORD* | out | オーディオ圧縮モードを受け取ります。次の値が定義されています。
| ||||||||
| AudioBitrateStepping | DWORD* | out | オーディオビットレートの最小増分を受け取ります。 | ||||||||
| AudioBitrate | DWORD* | out | オーディオビットレートを受け取ります。 | ||||||||
| AudioMethodID | DWORD* | out | 有効なオーディオエンコーダーメソッドを受け取ります。 | ||||||||
| AvailableAudioPrograms | DWORD* | out | エンコーダーが利用可能なオーディオプログラムの数を受け取ります。 | ||||||||
| AudioProgram | DWORD* | out | 現在エンコード中のオーディオプログラムのプログラム番号を受け取ります。 | ||||||||
| VideoBitrateMax | DWORD* | out | ビデオビットレートの最大値を受け取ります。 | ||||||||
| VideoBitrateMin | DWORD* | out | ビデオビットレートの最小値を受け取ります。 | ||||||||
| VideoBitrateMode | DWORD* | out | ビデオ圧縮モードを受け取ります。値の一覧については、AudioBitrateMode を参照してください。 | ||||||||
| VideoBitrate | DWORD* | out | ビデオビットレートを受け取ります。 | ||||||||
| VideoBitrateStepping | DWORD* | out | ビデオビットレートの最小増分を受け取ります。 | ||||||||
| VideoMethodID | DWORD* | out | 有効なビデオエンコーダーメソッドを受け取ります。 | ||||||||
| SignalSourceID | DWORD* | out | 信号ソースの識別子を受け取ります。この値は、IBDA_AUX::EnumCapability メソッドから返される補助コネクター ID です。 | ||||||||
| SignalFormat | ULONGLONG* | out | AnalogVideoStandard 列挙型の値を受け取ります。この値は、補助入力で受信されるアナログビデオ標準を指定します。 | ||||||||
| SignalLock | BOOL* | out | デバイスが信号ロックを取得している場合は TRUE、それ以外の場合は FALSE を受け取ります。 | ||||||||
| SignalLevel | INT* | out | 信号レベルをデシベル単位で受け取ります。 | ||||||||
| SignalToNoiseRatio | DWORD* | out | 信号対雑音比を示す 0 から 100 の値を受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IBDA_Encoder "{3A8BAD59-59FE-4559-A0BA-396CFAA98AE3}" #usecom global IBDA_Encoder IID_IBDA_Encoder "{}" #comfunc global IBDA_Encoder_QueryCapabilities 3 var,var #comfunc global IBDA_Encoder_EnumAudioCapability 4 int,var,var,var,var,var #comfunc global IBDA_Encoder_EnumVideoCapability 5 int,var,var,var,var,var,var,var #comfunc global IBDA_Encoder_SetParameters 6 int,int,int,int,int,int,int #comfunc global IBDA_Encoder_GetState 7 var,var,var,var,var,var,var,var,var,var,var,var,var,var,var,var,var,var,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IBDA_Encoder "{3A8BAD59-59FE-4559-A0BA-396CFAA98AE3}" #usecom global IBDA_Encoder IID_IBDA_Encoder "{}" #comfunc global IBDA_Encoder_QueryCapabilities 3 sptr,sptr #comfunc global IBDA_Encoder_EnumAudioCapability 4 int,sptr,sptr,sptr,sptr,sptr #comfunc global IBDA_Encoder_EnumVideoCapability 5 int,sptr,sptr,sptr,sptr,sptr,sptr,sptr #comfunc global IBDA_Encoder_SetParameters 6 int,int,int,int,int,int,int #comfunc global IBDA_Encoder_GetState 7 sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。