IEvalRat

IEvalRat インターフェースは、放送ストリームに含まれるコンテンツのレーティングを評価するために使用します。

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

get_BlockedRatingAttributes メソッドは、指定されたレーティングシステムおよびレーティングレベルに対してコンテンツがブロックされるかどうかを判定します。

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

戻り値	説明
E_INVALIDARG	引数が無効です。
E_POINTER	NULL ポインター引数です。
S_OK	メソッドが成功しました。

BfIsBlocked フラグが設定されている場合、指定されたレーティングレベルを持つすべてのコンテンツがブロックされます。BfIsAttr_X フラグのいずれかが設定されている場合、そのレーティングレベルおよび属性を持つコンテンツがブロックされます。

put_BlockedRatingAttributes メソッドは、指定されたレーティングを持つコンテンツをブロックするかどうかを指定します。

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

戻り値	説明
S_OK	メソッドが成功しました。

このメソッドは、レーティングシステム内の各レベルに対する視聴許可を指定するために、レベルごとに 1 回呼び出す必要があります。lbfAttrs パラメーターは、指定されたレーティングレベルに対する許可を示します:

• フラグが設定されていない場合、このレーティングレベルは制限されません。このレーティングレベルを持つ番組はすべて視聴できます。
• BflsBlocked フラグが設定されている場合、このレーティングレベルは制限されます。このレーティングレベルを持つ番組は視聴できません。
• BfIsAttr_1 から BfIsAttr_7 までの範囲のフラグは、暴力や成人向けの言葉などのコンテンツ属性を指定します。これらのフラグのいずれかが設定されている場合、そのコンテンツ属性と指定されたレーティングレベルを持つ番組がブロックされることを意味します。

get_BlockUnRated メソッドは、レーティング情報を持たない番組がブロックされるかどうかを示します。

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

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

put_BlockUnRated メソッドは、レーティング情報が取得されていない番組をブロックするかどうかを指定します。

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

戻り値	説明
S_OK	メソッドが成功しました。

MostRestrictiveRating メソッドは、2 つのレーティングを比較し、より制限の厳しい方を返します。

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

戻り値	説明
E_POINTER	NULL ポインター引数です。
S_FALSE	2 つのレーティングは異なるレーティングシステムのものです。
S_OK	メソッドが成功しました。

このメソッドを使用すると、クライアントは 2 つのレーティングのうちどちらがより制限が厳しいかを判定できます。たとえば、MPAA システムでは PG は R よりも制限が厳しくなります。より制限の厳しいレーティングは、penSystem、penEnLevel、plbfEnAttr の各パラメーターで返されます。

このメソッドが 2 つの異なるレーティングシステムのレーティングを比較する場合、1 つ目のシステムが不明 (TvRat_SystemDontKnow) でない限り、1 つ目のシステムで表現されたレーティングを返します。その場合は、2 つ目のシステムを使用したレーティングを返します。

レーティングシステムが同一でない場合、このメソッドは S_FALSE を返します。2 つのシステム間には正確な対応関係が存在しない場合があります。

TestRating メソッドは、指定されたレーティングを持つ番組をブロックすべきかどうかを判定します。

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

戻り値	説明
E_INVALIDARG	引数が無効です。
S_FALSE	この番組は制限されており、ブロックすべきです。
S_OK	この番組は許可されており、ブロックすべきではありません。

アプリケーションは、IEvalRat::put_BlockedRatingAttributes メソッドを通じて視聴許可を設定します。Decrypter/Detagger フィルターは、番組内で新しいレーティングを受け取るたびに TestRating を呼び出して、その番組をブロックするかどうかを判定します。TestRating が S_OK を返す場合、そのレーティングは現在の視聴許可のセットの下で制限されており、Decrypter/Tagger フィルターはその番組をブロックします。

実装に関する注意:

サポートする各レーティングシステムについて、そのシステム内の各レベルに対応するビットマスクを含むテーブルを保持します。オブジェクトの作成時に、各ビットマスクを 0 に初期化します。ビットマスクは put_BlockedRatingAttributes メソッドで更新します。

TestRating メソッドでは、enShowSystem および enShowLevel パラメーターを使用してテーブルルックアップを実行し、対応するビットマスクを取得します。次のいずれかの条件が真である場合は S_FALSE を返します:

• ビットマスクに BfIsBlocked フラグが設定されている
• lbfEnShowAttributes のいずれかの属性フラグがビットマスクにも設定されている。

ビットマスクのテストにはビット単位の AND を使用します。どちらの条件も真でない場合は S_OK を返します。

次のコードは実装の一例を示しています。オブジェクトが Mask という名前の 2 次元配列にビットマスクを格納していることを前提としています:

if ((0 != Mask[system][level] & BfIsBlocked) || 
    (0 != Mask[system][level] & attributes))
{
    return S_FALSE; // ブロックされます。
}
else
{
    return S_OK; // ブロックされません。
}

#define global IID_IEvalRat "{C5C5C5B1-3ABC-11D6-B25B-00C04FA0C026}"
#usecom global IEvalRat IID_IEvalRat "{C5C5C5F1-3ABC-11D6-B25B-00C04FA0C026}"
#comfunc global IEvalRat_get_BlockedRatingAttributes  7 int,int,var
#comfunc global IEvalRat_put_BlockedRatingAttributes  8 int,int,int
#comfunc global IEvalRat_get_BlockUnRated             9 var
#comfunc global IEvalRat_put_BlockUnRated             10 int
#comfunc global IEvalRat_MostRestrictiveRating        11 int,int,int,int,int,int,var,var,var
#comfunc global IEvalRat_TestRating                   12 int,int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。