ホーム › Media.DirectShow.Tv › IXDSToRat

IXDSToRat

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDc5c5c5b0-3abc-11d6-b25b-00c04fa0c026継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

IXDSToRat インターフェースは、line 21 の extended data services (XDS) 情報からレーティング情報を解析します。

解説(Remarks)

このインターフェースのインターフェース識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(IXDSToRat)。

メソッド 2

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT Init()

Init メソッドは、XDSToRat オブジェクトを初期状態に設定します。

戻り値

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

リターンコード	説明
S_OK	メソッドは成功しました。

解説(Remarks)

XDS Codec フィルターは、起動時、またはチャンネル変更などの不連続が発生した後にこのメソッドを呼び出します。XDSToRat オブジェクトは、内部バッファーをすべてクリアし、解析状態をリセットする必要があります。このメソッドは、チャンネル変更やその他の中断によって発生するデコードエラーを防ぎます。

vtbl 8 HRESULT ParseXDSBytePair(BYTE byte1, BYTE byte2, EnTvRat_System* pEnSystem, EnTvRat_GenericLevel* pEnLevel, INT* plBfEnAttributes)

byte1	BYTE	in	バイトペアの 1 番目のバイト。
byte2	BYTE	in	バイトペアの 2 番目のバイト。
pEnSystem	EnTvRat_System*	out	レーティングシステムを、EnTvRat_System 列挙型のメンバーとして受け取ります。
pEnLevel	EnTvRat_GenericLevel*	out	レーティングレベルを、EnTvRat_GenericLevel 列挙型のメンバーとして受け取ります。この値の意味はレーティングシステムによって異なります。
plBfEnAttributes	INT*	out	BfEnTvRat_GenericAttributes 列挙型から 0 個以上のフラグをビット単位で組み合わせた値を受け取ります。これらのフラグは、暴力や成人向けの言葉など、追加のコンテンツ属性を指定します。すべてのレーティングシステムに適用されるわけではありません。

戻り値

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

リターンコード	説明
S_OK	メソッドは成功しました。
S_FALSE	ストリーム内でまだレーティングが検出されていません。

解説(Remarks)

XDS Codec フィルターは、XDS データを XDSToRat オブジェクトに 1 回につき 1 組のバイトペアずつ渡すために、このメソッドを呼び出します。XDSToRat オブジェクトは、完全なレーティングパケットを解析できるように、呼び出し間で十分な情報を保持しておく必要があります。

このメソッドは、XDSToRat オブジェクトが完全なレーティングパケットをデコードするまで S_FALSE を返します。デコードが完了した時点で、メソッドは S_OK を返し、pEnSystem、pEnLevel、plBfEnAttributes の各パラメーターにレーティング情報を返します。以降の呼び出しは、次のパケットがデコードされるまで再び S_FALSE を返します。

レーティング値は、XDS Content Advisory パケット、または Composite Packet-1 パケットのいずれかで配信される場合があります。詳細については、EIA/CEA-608B 仕様のそれぞれ 9.5.1.5 節および 9.5.1.10 節を参照してください。

また、このメソッドは、番組の終了を示す Current Class Program Identification Number パケットおよび Program Name パケットを検出し、次の表の値とともに S_OK 値を返す必要があります。

レーティング以外のパケットについては、次の値を返してください。

パラメーター	値
pEnSystem	TvRat-SystemDontKnow
pEnLevel	TvRat_LevelDontKnow
plBfEnAttributes	BfAttrNone

詳細については、EIA/CEA-608-B 仕様の 9.5.1.5.4 節 (General Content Advisory Requirements) を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IXDSToRat "{C5C5C5B0-3ABC-11D6-B25B-00C04FA0C026}"
#usecom global IXDSToRat IID_IXDSToRat "{C5C5C5F0-3ABC-11D6-B25B-00C04FA0C026}"
#comfunc global IXDSToRat_Init              7
#comfunc global IXDSToRat_ParseXDSBytePair  8 int,int,var,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IXDSToRat "{C5C5C5B0-3ABC-11D6-B25B-00C04FA0C026}"
#usecom global IXDSToRat IID_IXDSToRat "{C5C5C5F0-3ABC-11D6-B25B-00C04FA0C026}"
#comfunc global IXDSToRat_Init              7
#comfunc global IXDSToRat_ParseXDSBytePair  8 int,int,sptr,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。