ホーム › Media.DirectShow › IAMTVTuner

IAMTVTuner

COM

📘 Microsoft Learn (日本語) · English

IID211a8766-03ac-11d1-8d13-00aa00bd8339継承元IAMTuner自前メソッド開始 vtbl18

公式ドキュメント

IAMTVTuner インターフェイスは、TV チューナーを制御します。

メソッド 11

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

vtbl 18 HRESULT get_AvailableTVFormats(INT* lAnalogVideoStandard)

get_AvailableTVFormats メソッドは、チューナーがサポートするすべてのアナログビデオ TV 規格を取得します。

lAnalogVideoStandard

INT*

out

AnalogVideoStandard 列挙体の値をビットごとに組み合わせた値を受け取る変数へのポインター。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

vtbl 19 HRESULT get_TVFormat(INT* plAnalogVideoStandard)

get_TVFormat メソッドは、現在使用中のアナログビデオ TV 規格を取得します。

plAnalogVideoStandard

INT*

out

AnalogVideoStandard 列挙体のメンバーを受け取る変数へのポインター。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

vtbl 20 HRESULT AutoTune(INT lChannel, INT* plFoundSignal)

AutoTune メソッドは、チャンネルの周波数に対して正確な信号を走査します。

lChannel	INT	in	TV チャンネル番号。
plFoundSignal	INT*	out	チャンネルの周波数が見つかったかどうかを示す変数へのポインター。0 以外は検出、0 は未検出を示します。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

解説(Remarks)

TV チャンネルは通常、地域による差異に応じて一意の周波数に対応付けられます。同じチャンネルが割り当てられた複数の送信機が地理的に近接している場合の干渉を避けるため、各送信機ではわずかな周波数オフセットが導入されています。米国では、このオフセットは最大 +/– 26.25 キロヘルツ (kHz) の範囲になります。

このメソッドは、チャンネルから周波数への変換を処理し、最も正確な周波数を走査します。これらの値は IAMTVTuner::StoreAutoTune メソッドを呼び出して保存します。チャンネルの基準周波数は付録 International Analog TV Tuning で確認できます。

vtbl 21 HRESULT StoreAutoTune()

StoreAutoTune メソッドは、すべてのチャンネルの微調整情報を保存します。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

解説(Remarks)

このメソッドで保存されるチャンネルから周波数への情報を上書きするには、IAMTuner::put_CountryCode メソッドで新しい国/地域コードを設定します。国/地域コードの一覧については、International Analog TV Tuning を参照してください。

vtbl 22 HRESULT get_NumInputConnections(INT* plNumInputConnections)

get_NumInputConnections メソッドは、チューナーフィルターに接続されている TV ソースの数を取得します。

plNumInputConnections

INT*

out

チューナーフィルターに接続されている TV ソースの数を受け取る変数へのポインター。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

vtbl 23 HRESULT put_InputType(INT lIndex, TunerInputType InputType)

put_InputType メソッドは、チューナーの入力タイプ (ケーブルまたはアンテナ) を設定します。

lIndex	INT	in	設定する入力ピンを指定するインデックス値。
InputType	TunerInputType	in	TunerInputType 列挙体で指定される、接続タイプを示す値。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

vtbl 24 HRESULT get_InputType(INT lIndex, TunerInputType* pInputType)

get_InputType メソッドは、IAMTVTuner::put_InputType で設定された入力タイプを取得します。

lIndex	INT	in	設定される入力ピンを指定するインデックス値。
pInputType	TunerInputType*	out	TunerInputType 列挙体のメンバーを受け取る変数へのポインター。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

vtbl 25 HRESULT put_ConnectInput(INT lIndex)

put_ConnectInput メソッドは、ハードウェアチューナーの入力接続を設定します。

lIndex

INT

接続を設定する入力ピンのインデックス値。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

vtbl 26 HRESULT get_ConnectInput(INT* plIndex)

get_ConnectInput メソッドは、ハードウェアチューナーの入力接続を取得します。

plIndex

INT*

out

接続を取得する入力ピンへのポインター。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

vtbl 27 HRESULT get_VideoFrequency(INT* lFreq)

get_VideoFrequency メソッドは、現在のビデオ周波数を取得します。

lFreq

INT*

out

ビデオ周波数 (ヘルツ (Hz) 単位) を受け取る変数へのポインター。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

解説(Remarks)

これは診断用のメソッドであり、特定のチャンネルに使用されている正確な周波数を調べることができます。

vtbl 28 HRESULT get_AudioFrequency(INT* lFreq)

get_AudioFrequency メソッドは、現在チューニングされているオーディオ周波数を取得します。

lFreq

INT*

out

オーディオ周波数 (ヘルツ (Hz) 単位) を受け取る変数へのポインター。

戻り値

インターフェイスの実装に依存する HRESULT 値を返します。

解説(Remarks)

これは診断用のメソッドであり、特定のチャンネルに使用されている正確な周波数を調べることができます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAMTVTuner "{211A8766-03AC-11D1-8D13-00AA00BD8339}"
#usecom global IAMTVTuner IID_IAMTVTuner "{}"
#comfunc global IAMTVTuner_get_AvailableTVFormats   18 var
#comfunc global IAMTVTuner_get_TVFormat             19 var
#comfunc global IAMTVTuner_AutoTune                 20 int,var
#comfunc global IAMTVTuner_StoreAutoTune            21
#comfunc global IAMTVTuner_get_NumInputConnections  22 var
#comfunc global IAMTVTuner_put_InputType            23 int,int
#comfunc global IAMTVTuner_get_InputType            24 int,var
#comfunc global IAMTVTuner_put_ConnectInput         25 int
#comfunc global IAMTVTuner_get_ConnectInput         26 var
#comfunc global IAMTVTuner_get_VideoFrequency       27 var
#comfunc global IAMTVTuner_get_AudioFrequency       28 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IAMTVTuner "{211A8766-03AC-11D1-8D13-00AA00BD8339}"
#usecom global IAMTVTuner IID_IAMTVTuner "{}"
#comfunc global IAMTVTuner_get_AvailableTVFormats   18 sptr
#comfunc global IAMTVTuner_get_TVFormat             19 sptr
#comfunc global IAMTVTuner_AutoTune                 20 int,sptr
#comfunc global IAMTVTuner_StoreAutoTune            21
#comfunc global IAMTVTuner_get_NumInputConnections  22 sptr
#comfunc global IAMTVTuner_put_InputType            23 int,int
#comfunc global IAMTVTuner_get_InputType            24 int,sptr
#comfunc global IAMTVTuner_put_ConnectInput         25 int
#comfunc global IAMTVTuner_get_ConnectInput         26 sptr
#comfunc global IAMTVTuner_get_VideoFrequency       27 sptr
#comfunc global IAMTVTuner_get_AudioFrequency       28 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。