ホーム › Media.DirectShow.Tv › IAtscContentAdvisoryDescriptor

IAtscContentAdvisoryDescriptor

COM

📘 Microsoft Learn (日本語) · English

IIDff76e60c-0283-43ea-ba32-b422238547ee継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

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

解説(Remarks)

このインターフェースへのポインターを取得するには、次の操作を行います。

IAtscPsipParser::GetEIT を呼び出して IATSC_EIT インターフェースを取得します。
IATSC_EIT::GetRecordDescriptorByTag を呼び出し、content advisory descriptor タグ (0x87) を渡します。記述子が存在する場合、このメソッドは IGenericDescriptor ポインターを返します。
返された IGenericDescriptor ポインターに対して IAtscContentAdvisoryDescriptor インターフェースをクエリします。

メソッド 8

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

vtbl 3 HRESULT GetTag(BYTE* pbVal)

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

pbVal

BYTE*

out

記述子タグを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定可能な値には次の表の値が含まれますが、これらに限定されません。

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

vtbl 4 HRESULT GetLength(BYTE* pbVal)

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

pbVal

BYTE*

out

記述子本体の長さをバイト単位で受け取ります。

戻り値

このメソッドは HRESULT を返します。指定可能な値には次の表の値が含まれますが、これらに限定されません。

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

vtbl 5 HRESULT GetRatingRegionCount(BYTE* pbVal)

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

pbVal

BYTE*

out

rating_region_count フィールドを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定可能な値には次の表の値が含まれますが、これらに限定されません。

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

vtbl 6 HRESULT GetRecordRatingRegion(BYTE bIndex, BYTE* pbVal)

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

bIndex	BYTE	in	レーティングリージョンの 0 から始まるインデックス。レーティングリージョンの数を取得するには IAtscContentAdvisoryDescriptor::GetRatingRegionCount を呼び出します。
pbVal	BYTE*	out	rating_region フィールドを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定可能な値には次の表の値が含まれますが、これらに限定されません。

リターンコード	説明
MPEG2_E_OUT_OF_BOUNDS	bIndex パラメーターが範囲外です。
S_OK	メソッドは成功しました。

vtbl 7 HRESULT GetRecordRatedDimensions(BYTE bIndex, BYTE* pbVal)

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

bIndex	BYTE	in	レーティングリージョンの 0 から始まるインデックス。レーティングリージョンの数を取得するには IAtscContentAdvisoryDescriptor::GetRatingRegionCount を呼び出します。
pbVal	BYTE*	out	rated_dimensions フィールドを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定可能な値には次の表の値が含まれますが、これらに限定されません。

リターンコード	説明
MPEG2_E_OUT_OF_BOUNDS	bIndex パラメーターが範囲外です。
S_OK	メソッドは成功しました。

vtbl 8 HRESULT GetRecordRatingDimension(BYTE bIndexOuter, BYTE bIndexInner, BYTE* pbVal)

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

bIndexOuter	BYTE	in	レーティングリージョンの 0 から始まるインデックス。レーティングリージョンの数を取得するには IAtscContentAdvisoryDescriptor::GetRatingRegionCount を呼び出します。
bIndexInner	BYTE	in	レーティングディメンションの 0 から始まるインデックス。レーティングディメンションの数を取得するには IAtscContentAdvisoryDescriptor::GetRecordRatedDimensions を呼び出します。
pbVal	BYTE*	out	rating_dimension_j フィールドを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定可能な値には次の表の値が含まれますが、これらに限定されません。

リターンコード	説明
S_OK	メソッドは成功しました。
MPEG2_E_OUT_OF_BOUNDS	bIndexOuter または bIndexInner パラメーターが範囲外です。

vtbl 9 HRESULT GetRecordRatingValue(BYTE bIndexOuter, BYTE bIndexInner, BYTE* pbVal)

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

bIndexOuter	BYTE	in	レーティングリージョンの 0 から始まるインデックス。レーティングリージョンの数を取得するには IAtscContentAdvisoryDescriptor::GetRatingRegionCount を呼び出します。
bIndexInner	BYTE	in	レーティングディメンションの 0 から始まるインデックス。レーティングディメンションの数を取得するには IAtscContentAdvisoryDescriptor::GetRecordRatedDimensions を呼び出します。
pbVal	BYTE*	out	rating_value フィールドを受け取ります

戻り値

このメソッドは HRESULT を返します。指定可能な値には次の表の値が含まれますが、これらに限定されません。

リターンコード	説明
MPEG2_E_OUT_OF_BOUNDS	bIndexOuter または bIndexInner パラメーターが範囲外です。
S_OK	メソッドは成功しました。

vtbl 10 HRESULT GetRecordRatingDescriptionText(BYTE bIndex, BYTE* pbLength, BYTE** ppText)

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

bIndex	BYTE	in	レーティングリージョンの 0 から始まるインデックス。レーティングリージョンの数を取得するには IAtscContentAdvisoryDescriptor::GetRatingRegionCount を呼び出します。
pbLength	BYTE*	out	rating_description_length フィールドを受け取ります。
ppText	BYTE**	out	rating_description_text フィールドを含むバッファーへのポインターを受け取ります。このテキストは ATSC PSIP Standard A/65 で定義される Multiple String Structure として書式設定されます。呼び出し側は CoTaskMemFree 関数を呼び出してバッファーを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。指定可能な値には次の表の値が含まれますが、これらに限定されません。

リターンコード	説明
MPEG2_E_OUT_OF_BOUNDS	bIndex パラメーターが範囲外です。
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_IAtscContentAdvisoryDescriptor "{FF76E60C-0283-43EA-BA32-B422238547EE}"
#usecom global IAtscContentAdvisoryDescriptor IID_IAtscContentAdvisoryDescriptor "{}"
#comfunc global IAtscContentAdvisoryDescriptor_GetTag                          3 var
#comfunc global IAtscContentAdvisoryDescriptor_GetLength                       4 var
#comfunc global IAtscContentAdvisoryDescriptor_GetRatingRegionCount            5 var
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatingRegion           6 int,var
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatedDimensions        7 int,var
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatingDimension        8 int,int,var
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatingValue            9 int,int,var
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatingDescriptionText  10 int,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IAtscContentAdvisoryDescriptor "{FF76E60C-0283-43EA-BA32-B422238547EE}"
#usecom global IAtscContentAdvisoryDescriptor IID_IAtscContentAdvisoryDescriptor "{}"
#comfunc global IAtscContentAdvisoryDescriptor_GetTag                          3 sptr
#comfunc global IAtscContentAdvisoryDescriptor_GetLength                       4 sptr
#comfunc global IAtscContentAdvisoryDescriptor_GetRatingRegionCount            5 sptr
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatingRegion           6 int,sptr
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatedDimensions        7 int,sptr
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatingDimension        8 int,int,sptr
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatingValue            9 int,int,sptr
#comfunc global IAtscContentAdvisoryDescriptor_GetRecordRatingDescriptionText  10 int,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。