ホーム › Media.DirectShow.Tv › IDVB_NIT

IDVB_NIT

COM

📘 Microsoft Learn (日本語) · English

IIDc64935f4-29e4-4e22-911a-63f7f55cb097継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

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

メソッド 17

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

vtbl 3 HRESULT Initialize(ISectionList* pSectionList, IMpeg2Data* pMPEGData)

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

pSectionList	ISectionList*	in	セクションデータを格納する SectionList オブジェクトの ISectionList インターフェイスへのポインター。
pMPEGData	IMpeg2Data*	in	MPEG-2 Sections and Tables フィルターの IMpeg2Data インターフェイスへのポインター。

戻り値

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

リターンコード	説明
E_INVALIDARG	引数が無効です。
MPEG2_E_ALREADY_INITIALIZED	オブジェクトはすでに初期化されています。
MPEG2_E_MALFORMED_TABLE	テーブルが不正な形式です。
S_OK	メソッドが成功しました。

vtbl 4 HRESULT GetVersionNumber(BYTE* pbVal)

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

pbVal

BYTE*

out

version_number フィールドを受け取る変数へのポインター。

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
S_OK	メソッドが成功しました。

vtbl 5 HRESULT GetNetworkId(WORD* pwVal)

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

pwVal

WORD*

out

network_id フィールドを受け取る変数へのポインター。

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
S_OK	メソッドが成功しました。

vtbl 6 HRESULT GetCountOfTableDescriptors(DWORD* pdwVal)

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

pdwVal

DWORD*

out

記述子の数を受け取る変数へのポインター。

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
S_OK	メソッドが成功しました。

vtbl 7 HRESULT GetTableDescriptorByIndex(DWORD dwIndex, IGenericDescriptor** ppDescriptor)

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

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

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドが成功しました。

vtbl 8 HRESULT GetTableDescriptorByTag(BYTE bTag, DWORD* pdwCookie, IGenericDescriptor** ppDescriptor)

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

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

戻り値

このメソッドは 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 にさらに含まれているかどうかを示します。

vtbl 9 HRESULT GetCountOfRecords(DWORD* pdwVal)

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

pdwVal

DWORD*

out

レコードの数を受け取る変数へのポインター。

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
S_OK	メソッドが成功しました。

vtbl 10 HRESULT GetRecordTransportStreamId(DWORD dwRecordIndex, WORD* pwVal)

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

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。NIT 内のレコードの数を取得するには、IDVB_NIT::GetCountOfRecords メソッドを呼び出します。
pwVal	WORD*	out	transport_stream_id フィールドを受け取る変数へのポインター。この値は、多重化 (multiplex) 内の他のトランスポートストリームからこのトランスポートストリームを識別します。

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドが成功しました。

vtbl 11 HRESULT GetRecordOriginalNetworkId(DWORD dwRecordIndex, WORD* pwVal)

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

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。NIT 内のレコードの数を取得するには、IDVB_NIT::GetCountOfRecords メソッドを呼び出します。
pwVal	WORD*	out	original_network_id フィールドを受け取る変数へのポインター。この値は、発信元の配信システム (delivery system) の network_id を識別します。

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドが成功しました。

vtbl 12 HRESULT GetRecordCountOfDescriptors(DWORD dwRecordIndex, DWORD* pdwVal)

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

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。NIT 内のレコードの数を取得するには、IDVB_NIT::GetCountOfRecords メソッドを呼び出します。
pdwVal	DWORD*	out	記述子の数を受け取る変数へのポインター。

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドが成功しました。

vtbl 13 HRESULT GetRecordDescriptorByIndex(DWORD dwRecordIndex, DWORD dwIndex, IGenericDescriptor** ppDescriptor)

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

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。NIT 内のレコードの数を取得するには、IDVB_NIT::GetCountOfRecords メソッドを呼び出します。
dwIndex	DWORD	in	取得する記述子を 0 から始まるインデックスで指定します。特定のレコードの記述子の数を取得するには、IDVB_NIT::GetRecordCountOfDescriptors メソッドを呼び出します。
ppDescriptor	IGenericDescriptor**	out	IGenericDescriptor インターフェイスポインターを受け取る変数のアドレス。このインターフェイスを使用して記述子内の情報を取得します。呼び出し元はインターフェイスを解放する必要があります。

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドが成功しました。

vtbl 14 HRESULT GetRecordDescriptorByTag(DWORD dwRecordIndex, BYTE bTag, DWORD* pdwCookie, IGenericDescriptor** ppDescriptor)

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

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。NIT 内のレコードの数を取得するには、IDVB_NIT::GetCountOfRecords メソッドを呼び出します。
bTag	BYTE	in	検索対象の記述子タグを指定します。
pdwCookie	DWORD*	inoutoptional	記述子リスト内の開始位置を指定する変数へのポインター。このパラメーターは省略可能です。pdwCookie の値が NULL の場合、検索はリストの最初の記述子から開始されます。それ以外の場合、検索は pdwCookie で指定された位置から開始されます。メソッドが戻るとき、pdwCookie パラメーターには、一致する次の記述子があればその位置が格納されます。このパラメーターを使用して記述子リストを反復処理し、特定の記述子タグのすべてのインスタンスを検索できます。
ppDescriptor	IGenericDescriptor**	out	IGenericDescriptor インターフェイスポインターを受け取る変数のアドレス。このインターフェイスを使用して記述子内の情報を取得します。呼び出し元はインターフェイスを解放する必要があります。

戻り値

このメソッドは 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 を返し、検索条件に一致するタグがレコードにさらに含まれているかどうかを示します。

vtbl 15 HRESULT RegisterForNextTable(HANDLE hNextTableAvailable)

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

hNextTableAvailable

HANDLE

呼び出し元が作成したイベントへのハンドル。next テーブルが到着すると、オブジェクトはこのイベントをシグナル状態にします。イベントがシグナル状態になったら、IDVB_NIT::GetNextTable メソッドを呼び出してテーブルを取得します。

戻り値

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

リターンコード	説明
E_ACCESSDENIED	このテーブルはすでに next テーブルです。
E_INVALIDARG	引数が無効です。hNextTableAvailable を NULL にすることはできません。
MPEG2_E_ALREADY_INITIALIZED	メソッドはすでに呼び出されています。
S_OK	メソッドが成功しました。

解説(Remarks)

このメソッドは current テーブルにのみ適用されます。それ以外の場合、メソッドは E_ACCESSDENIED を返します。

vtbl 16 HRESULT GetNextTable(IDVB_NIT** ppNIT)

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

ppNIT

IDVB_NIT**

out

IDVB_NIT インターフェイスポインターを受け取る変数のアドレス。呼び出し元はインターフェイスを解放する必要があります。

戻り値

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

リターンコード	説明
E_ACCESSDENIED	このテーブルは current ではありません。
E_FAIL	失敗しました。
S_OK	メソッドが成功しました。

解説(Remarks)

このメソッドは current テーブルにのみ適用されます。それ以外の場合、メソッドは E_ACCESSDENIED を返します。

vtbl 17 HRESULT RegisterForWhenCurrent(HANDLE hNextTableIsCurrent)

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

hNextTableIsCurrent

HANDLE

呼び出し元が作成したイベントへのハンドル。テーブルが current になると、オブジェクトはこのイベントをシグナル状態にします。

戻り値

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

リターンコード	説明
E_ACCESSDENIED	このテーブルはすでに current テーブルです。
E_INVALIDARG	引数が無効です。hNextTableIsCurrent を NULL にすることはできません。
MPEG2_E_ALREADY_INITIALIZED	メソッドはすでに呼び出されています。
S_OK	メソッドが成功しました。

解説(Remarks)

このメソッドは next テーブルにのみ適用されます。それ以外の場合、メソッドは E_ACCESSDENIED を返します。

vtbl 18 HRESULT ConvertNextToCurrent()

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

戻り値

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

リターンコード	説明
E_ACCESSDENIED	このテーブルはすでに current です。
E_INVALIDARG	RegisterForWhenCurrent メソッドが呼び出されていません。
MPEG2_E_MALFORMED_TABLE	新しい current テーブルが不正な形式です。
S_OK	メソッドが成功しました。

解説(Remarks)

このメソッドは、current になった next テーブルにのみ適用されます。このメソッドを呼び出す前に、IDVB_NIT::RegisterForWhenCurrent を呼び出し、イベントがシグナル状態になるのを待ちます。

vtbl 19 HRESULT GetVersionHash(DWORD* pdwVersionHash)

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

pdwVersionHash

DWORD*

out

ハッシュ値を受け取ります。

戻り値

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

リターンコード	説明
E_POINTER	NULL ポインター引数です。
S_OK	メソッドが成功しました。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_NIT "{C64935F4-29E4-4E22-911A-63F7F55CB097}"
#usecom global IDVB_NIT IID_IDVB_NIT "{}"
#comfunc global IDVB_NIT_Initialize                   3 sptr,sptr
#comfunc global IDVB_NIT_GetVersionNumber             4 var
#comfunc global IDVB_NIT_GetNetworkId                 5 var
#comfunc global IDVB_NIT_GetCountOfTableDescriptors   6 var
#comfunc global IDVB_NIT_GetTableDescriptorByIndex    7 int,sptr
#comfunc global IDVB_NIT_GetTableDescriptorByTag      8 int,var,sptr
#comfunc global IDVB_NIT_GetCountOfRecords            9 var
#comfunc global IDVB_NIT_GetRecordTransportStreamId   10 int,var
#comfunc global IDVB_NIT_GetRecordOriginalNetworkId   11 int,var
#comfunc global IDVB_NIT_GetRecordCountOfDescriptors  12 int,var
#comfunc global IDVB_NIT_GetRecordDescriptorByIndex   13 int,int,sptr
#comfunc global IDVB_NIT_GetRecordDescriptorByTag     14 int,int,var,sptr
#comfunc global IDVB_NIT_RegisterForNextTable         15 sptr
#comfunc global IDVB_NIT_GetNextTable                 16 sptr
#comfunc global IDVB_NIT_RegisterForWhenCurrent       17 sptr
#comfunc global IDVB_NIT_ConvertNextToCurrent         18
#comfunc global IDVB_NIT_GetVersionHash               19 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IDVB_NIT "{C64935F4-29E4-4E22-911A-63F7F55CB097}"
#usecom global IDVB_NIT IID_IDVB_NIT "{}"
#comfunc global IDVB_NIT_Initialize                   3 sptr,sptr
#comfunc global IDVB_NIT_GetVersionNumber             4 sptr
#comfunc global IDVB_NIT_GetNetworkId                 5 sptr
#comfunc global IDVB_NIT_GetCountOfTableDescriptors   6 sptr
#comfunc global IDVB_NIT_GetTableDescriptorByIndex    7 int,sptr
#comfunc global IDVB_NIT_GetTableDescriptorByTag      8 int,sptr,sptr
#comfunc global IDVB_NIT_GetCountOfRecords            9 sptr
#comfunc global IDVB_NIT_GetRecordTransportStreamId   10 int,sptr
#comfunc global IDVB_NIT_GetRecordOriginalNetworkId   11 int,sptr
#comfunc global IDVB_NIT_GetRecordCountOfDescriptors  12 int,sptr
#comfunc global IDVB_NIT_GetRecordDescriptorByIndex   13 int,int,sptr
#comfunc global IDVB_NIT_GetRecordDescriptorByTag     14 int,int,sptr,sptr
#comfunc global IDVB_NIT_RegisterForNextTable         15 sptr
#comfunc global IDVB_NIT_GetNextTable                 16 sptr
#comfunc global IDVB_NIT_RegisterForWhenCurrent       17 sptr
#comfunc global IDVB_NIT_ConvertNextToCurrent         18
#comfunc global IDVB_NIT_GetVersionHash               19 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。