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

IDVB_TOT

COM
IID83295d6a-faba-4ee1-9b15-8067696910ae継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

このトピックは、Microsoft Windows XP Media Center Edition 2005 の Update Rollup 2 以降に適用されます。

メソッド 5

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

vtbl 3 HRESULT Initialize(ISectionList* pSectionList)

このトピックは、Microsoft Windows XP Media Center Edition 2005 の Update Rollup 2 以降に適用されます。

pSectionListISectionList*inセクションデータを含む SectionList オブジェクトの ISectionList インターフェースへのポインターです。

戻り値

このメソッドは HRESULT を返します。取り得る値には次の表の値が含まれます。

戻り値 説明
E_INVALIDARG
無効な引数です。
MPEG2_E_ALREADY_INITIALIZED
オブジェクトは既に初期化されています。
MPEG2_E_MALFORMED_TABLE
テーブルの形式が不正です。
S_OK
メソッドは成功しました。
vtbl 4 HRESULT GetUTCTime(MPEG_DATE_AND_TIME* pmdtVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 の Update Rollup 2 以降に適用されます。

pmdtValMPEG_DATE_AND_TIME*out呼び出し側が割り当てた MPEG_DATE_AND_TIME 構造体へのポインターです。このメソッドは、この構造体に UTC の時刻と日付を格納します。

戻り値

このメソッドは HRESULT を返します。取り得る値には次の表の値が含まれます。

戻り値 説明
E_POINTER
NULL ポインター引数です。
S_OK
メソッドは成功しました。
vtbl 5 HRESULT GetCountOfTableDescriptors(DWORD* pdwVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 の Update Rollup 2 以降に適用されます。

pdwValDWORD*out記述子の数を受け取る変数へのポインターです。

戻り値

このメソッドは HRESULT を返します。取り得る値には次の表の値が含まれます。

戻り値 説明
E_POINTER
NULL ポインター引数です。
S_OK
メソッドは成功しました。
vtbl 6 HRESULT GetTableDescriptorByIndex(DWORD dwIndex, IGenericDescriptor** ppDescriptor)

このトピックは、Microsoft Windows XP Media Center Edition 2005 の Update Rollup 2 以降に適用されます。

dwIndexDWORDin取得する記述子を、0 から始まるインデックスで指定します。TOT 内のテーブル記述子の数を取得するには、IDVB_TOT::GetCountOfTableDescriptors メソッドを呼び出します。
ppDescriptorIGenericDescriptor**outIGenericDescriptor インターフェースポインターを受け取る変数のアドレスです。このインターフェースを使用して、記述子内の情報を取得します。呼び出し側はインターフェースを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。取り得る値には次の表の値が含まれます。

戻り値 説明
E_POINTER
NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS
インデックスが範囲外です。
S_OK
メソッドは成功しました。
vtbl 7 HRESULT GetTableDescriptorByTag(BYTE bTag, DWORD* pdwCookie, IGenericDescriptor** ppDescriptor)

このトピックは、Microsoft Windows XP Media Center Edition 2005 の Update Rollup 2 以降に適用されます。

bTagBYTEin検索対象の記述子タグを指定します。
pdwCookieDWORD*inoutoptional記述子リスト内の検索開始位置を指定する変数へのポインターです。このパラメーターは省略可能です。pdwCookie の値が NULL の場合、検索はリストの最初の記述子から開始されます。それ以外の場合、検索は pdwCookie で指定された位置から開始されます。メソッドが返るとき、pdwCookie パラメーターには、次に一致する記述子があればその位置が格納されます。このパラメーターを使用して記述子リストを反復処理し、特定の記述子タグのすべてのインスタンスを検索できます。
ppDescriptorIGenericDescriptor**outIGenericDescriptor インターフェースポインターを受け取る変数のアドレスです。このインターフェースを使用して、記述子内の情報を取得します。呼び出し側はインターフェースを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。取り得る値には次の表の値が含まれます。

戻り値 説明
MPEG2_E_OUT_OF_BOUNDS
インデックスが範囲外です。
MPEG2_E_NOT_PRESENT
指定されたタグが見つかりませんでした。
MPEG2_S_MORE_DATA_AVAILABLE
レコードには、このタグを持つ記述子がさらに 1 つ以上含まれています。
MPEG2_S_NO_MORE_DATA_AVAILABLE
レコードには、このタグを持つ記述子はこれ以上含まれていません。
S_OK
メソッドは成功しました。

解説(Remarks)

pdwCookie の値が NULL でない場合、メソッドは MPEG2_S_NO_MORE_DATA_AVAILABLE または MPEG2_S_MORE_DATA_AVAILABLE のいずれかを返し、MGT に検索条件に一致する追加のタグが含まれているかどうかを示します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IDVB_TOT "{83295D6A-FABA-4EE1-9B15-8067696910AE}"
#usecom global IDVB_TOT IID_IDVB_TOT "{}"
#comfunc global IDVB_TOT_Initialize                  3 sptr
#comfunc global IDVB_TOT_GetUTCTime                  4 var
#comfunc global IDVB_TOT_GetCountOfTableDescriptors  5 var
#comfunc global IDVB_TOT_GetTableDescriptorByIndex   6 int,sptr
#comfunc global IDVB_TOT_GetTableDescriptorByTag     7 int,var,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。