ホーム › Media.DirectShow.Tv › IMpeg2Data
IMpeg2Data
COM公式ドキュメント
IMpeg2Data は Windows 7 以降では使用できません。
解説(Remarks)
このインターフェースのインターフェース識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(IMpeg2Data)。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT GetSection(WORD pid, BYTE tid, MPEG2_FILTER* pFilter, DWORD dwTimeout, ISectionList** ppSectionList)
GetSection は Windows 7 以降では使用できません。
| pid | WORD | in | 検査するトランスポートストリームパケットのパケット識別子 (PID) を指定します。 |
| tid | BYTE | in | 取得するセクションのテーブル識別子 (TID) を指定します。 |
| pFilter | MPEG2_FILTER* | in | MPEG2_FILTER 構造体への省略可能なポインターです。呼び出し側はこのパラメーターを使用して、追加の MPEG-2 ヘッダーフィールドに基づいてパケットを除外できます。このパラメーターは NULL にできます。 |
| dwTimeout | DWORD | in | タイムアウト値をミリ秒単位で指定します。タイムアウト期間内にフィルターが一致するセクションを受信しない場合、このメソッドは失敗します。 |
| ppSectionList | ISectionList** | out | ISectionList インターフェースポインターを受け取る変数へのポインターです。このインターフェースを使用してセクションデータを取得します。呼び出し側はこのインターフェースを解放する必要があります。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| 引数が無効です。 | |
| フィルターが一致するテーブルセクションを受信しませんでした。 |
vtbl 4 HRESULT GetTable(WORD pid, BYTE tid, MPEG2_FILTER* pFilter, DWORD dwTimeout, ISectionList** ppSectionList)
GetTable は Windows 7 以降では使用できません。
| pid | WORD | in | 検査するトランスポートストリームパケットのパケット識別子 (PID) を指定します。 |
| tid | BYTE | in | 取得するセクションのテーブル識別子 (TID) を指定します。 |
| pFilter | MPEG2_FILTER* | in | MPEG2_FILTER 構造体への省略可能なポインターです。呼び出し側はこのパラメーターを使用して、追加の MPEG-2 ヘッダーフィールドに基づいてパケットを除外できます。このパラメーターは NULL にできます。 |
| dwTimeout | DWORD | in | タイムアウト値をミリ秒単位で指定します。タイムアウト期間内にフィルターが一致するセクションを受信しない場合、このメソッドは失敗します。 |
| ppSectionList | ISectionList** | out | ISectionList インターフェースポインターを受け取ります。このインターフェースを使用してセクションデータを取得します。呼び出し側はこのインターフェースを解放する必要があります。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| 戻り値 | 説明 |
|---|---|
| フィルターが一致するテーブルセクションを受信しませんでした。 | |
| メソッドは成功しました。 |
解説(Remarks)
pFilter パラメーターを使用して、Table_ID_extension フィールドまたはバージョン番号フィールドを指定できます。指定しない場合、フィルターは検索条件に一致する最初のセクションからこれらの値をキャッシュします。フィルターはそれらの値を使用して後続のセクションを照合します。
vtbl 5 HRESULT GetStreamOfSections(WORD pid, BYTE tid, MPEG2_FILTER* pFilter, HANDLE hDataReadyEvent, IMpeg2Stream** ppMpegStream)
GetStreamOfSections は Windows 7 以降では使用できません。
| pid | WORD | in | 検査するトランスポートストリームパケットのパケット識別子 (PID) を指定します。 |
| tid | BYTE | in | 取得するセクションのテーブル識別子 (TID) を指定します。 |
| pFilter | MPEG2_FILTER* | in | MPEG2_FILTER 構造体への省略可能なポインターです。呼び出し側はこのパラメーターを使用して、追加の MPEG-2 ヘッダーフィールドに基づいてパケットを除外できます。このパラメーターは NULL にできます。 |
| hDataReadyEvent | HANDLE | in | 呼び出し側が作成したイベントへのハンドルです。フィルターは新しいデータを受信するたびにこのイベントをシグナル状態にします。 |
| ppMpegStream | IMpeg2Stream** | out | IMpeg2Stream インターフェースポインターを受け取る変数へのポインターです。呼び出し側はこのインターフェースを解放する必要があります。データが到着したときにこのインターフェースを使用してデータを取得します。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| 戻り値 | 説明 |
|---|---|
| 引数が無効です。 | |
| NULL ポインター引数です。 | |
| メソッドは成功しました。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMpeg2Data "{9B396D40-F380-4E3C-A514-1A82BF6EBFE6}" #usecom global IMpeg2Data IID_IMpeg2Data "{C666E115-BB62-4027-A113-82D643FE2D99}" #comfunc global IMpeg2Data_GetSection 3 int,int,var,int,sptr #comfunc global IMpeg2Data_GetTable 4 int,int,var,int,sptr #comfunc global IMpeg2Data_GetStreamOfSections 5 int,int,var,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IMpeg2Data "{9B396D40-F380-4E3C-A514-1A82BF6EBFE6}" #usecom global IMpeg2Data IID_IMpeg2Data "{C666E115-BB62-4027-A113-82D643FE2D99}" #comfunc global IMpeg2Data_GetSection 3 int,int,sptr,int,sptr #comfunc global IMpeg2Data_GetTable 4 int,int,sptr,int,sptr #comfunc global IMpeg2Data_GetStreamOfSections 5 int,int,sptr,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。