Win32 API 日本語リファレンス
ホーム › Media.DirectShow › IBDA_ConditionalAccess

IBDA_ConditionalAccess

COM
📘 Microsoft Learn (日本語) · English
IIDcd51f1e0-7be9-4123-8482-a2a796c0a6b0継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IBDA_ConditionalAccess インターフェイスは、番組コンテンツへの条件付きアクセス(コンディショナルアクセス)を提供します。

解説(Remarks)

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

メソッド 10

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

vtbl 3 HRESULT get_SmartCardStatus(SmartCardStatusType* pCardStatus, SmartCardAssociationType* pCardAssociation, LPWSTR* pbstrCardError, VARIANT_BOOL* pfOOBLocked)

get_SmartCardStatus メソッドは、スマートカードの状態を取得します。

pCardStatusSmartCardStatusType*outカード状態の種類を受け取る、SmartCardStatusType 型の変数へのポインター。
pCardAssociationSmartCardAssociationType*outカードの関連付けの種類を受け取る、SmartCardAssociationType 型の変数へのポインター。
pbstrCardErrorLPWSTR*outカードエラーを含む文字列を受け取ります。この文字列が不要になったら、SysFreeString 関数を呼び出して解放してください。
pfOOBLockedVARIANT_BOOL*out操作がブロックされているかどうかを示す値を受け取ります。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

解説(Remarks)

3 つのパラメーターはすべて非 NULL でなければなりません。そうでない場合、メソッドは失敗し E_POINTER を返します。

vtbl 4 HRESULT get_SmartCardInfo(LPWSTR* pbstrCardName, LPWSTR* pbstrCardManufacturer, VARIANT_BOOL* pfDaylightSavings, BYTE* pbyRatingRegion, INT* plTimeZoneOffsetMinutes, LPWSTR* pbstrLanguage, EALocationCodeType* pEALocationCode)

get_SmartCardInfo メソッドは、スマートカードに関する情報を取得します。

pbstrCardNameLPWSTR*outカード名を含む文字列を受け取ります。この文字列が不要になったら、SysFreeString 関数を呼び出して解放してください。
pbstrCardManufacturerLPWSTR*outカード製造元の名前を含む文字列を受け取ります。この文字列が不要になったら、SysFreeString 関数を呼び出して解放してください。
pfDaylightSavingsVARIANT_BOOL*outサマータイム(夏時間)が有効かどうかを示す値を受け取ります。値が VARIANT_TRUE の場合、サマータイムは有効です。値が VARIANT_FALSE の場合、サマータイムは無効です。
pbyRatingRegionBYTE*outレーティング地域を示す値を受け取ります。
plTimeZoneOffsetMinutesINT*outタイムゾーンのオフセットを分単位で受け取ります。
pbstrLanguageLPWSTR*out言語を示す文字列を受け取ります。この文字列が不要になったら、SysFreeString 関数を呼び出して解放してください。
pEALocationCodeEALocationCodeType*out緊急警報の位置コード情報を受け取るバッファーへのポインター。バッファーのサイズは少なくとも sizeof(EALocationCodeType) でなければなりません。メソッドは EALocationCodeType 型の構造体をバッファーに書き込みます。この構造体は、緊急警報の位置コード方式(例: SCTE 18)、州、郡、および郡の細分区分を指定します。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 5 HRESULT get_SmartCardApplications(DWORD* pulcApplications, DWORD ulcApplicationsMax, SmartCardApplication* rgApplications)

get_SmartCardApplications メソッドは、スマートカードアプリケーションの一覧を取得します。

pulcApplicationsDWORD*inoutrgApplications 配列内のスマートカードアプリケーションの数を受け取ります。
ulcApplicationsMaxDWORDinrgApplications バッファーが保持できるスマートカードアプリケーションの最大数。
rgApplicationsSmartCardApplication*inoutスマートカードアプリケーションの配列を受け取るバッファーへのポインター。各配列要素は SmartCardApplication 構造体です。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

解説(Remarks)

注 pulcApplications パラメーターは IDL ファイル内で [in, out] としてマークされていますが、[in] パラメーターとして使用されます。以前のバージョンとのバイナリ互換性を保つため、変更されていません。
vtbl 6 HRESULT get_Entitlement(WORD usVirtualChannel, EntitlementType* pEntitlement)

get_Entitlement メソッドは、仮想チャンネルのエンタイトルメント(利用権)の種類を取得します。

usVirtualChannelWORDin仮想チャンネル番号を指定します。
pEntitlementEntitlementType*outエンタイトルメントの種類を受け取ります。

戻り値

E_NOTIMPL を返します。

vtbl 7 HRESULT TuneByChannel(WORD usVirtualChannel)

TuneByChannel メソッドは、仮想チャンネルに選局します。

usVirtualChannelWORDin仮想チャンネル番号を指定します。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 8 HRESULT SetProgram(WORD usProgramNumber)

SetProgram メソッドは、プログラム番号を設定します。

usProgramNumberWORDinプログラム番号を指定します。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 9 HRESULT AddProgram(WORD usProgramNumber)

現在は実装されていません。

usProgramNumberWORDin予約済み。

戻り値

E_NOTIMPL を返します。

vtbl 10 HRESULT RemoveProgram(WORD usProgramNumber)

現在は実装されていません。

usProgramNumberWORDin予約済み。

戻り値

E_NOTIMPL を返します。

vtbl 11 HRESULT GetModuleUI(BYTE byDialogNumber, LPWSTR* pbstrURL)

GetModuleUI メソッドは、ユーザーインターフェイスのダイアログの URL を取得します。

byDialogNumberBYTEinダイアログ番号を指定します。
pbstrURLLPWSTR*outURL を含む文字列へのポインターを受け取る、ポインター変数へのポインター。この文字列が不要になったら、SysFreeString 関数を呼び出して解放してください。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

vtbl 12 HRESULT InformUIClosed(BYTE byDialogNumber, UICloseReasonType CloseReason)

InformUIClosed メソッドは、ユーザーインターフェイスのダイアログが閉じられたことをデバイスに通知します。

byDialogNumberBYTEinダイアログ番号を指定します。
CloseReasonUICloseReasonTypeinダイアログを閉じる理由を、UICloseReasonType 列挙体のメンバーとして指定します。

戻り値

メソッドが成功した場合は S_OK を返します。指定されたダイアログ番号のダイアログが見つからない場合は S_FALSE を返します。メソッドが失敗した場合はエラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IBDA_ConditionalAccess "{CD51F1E0-7BE9-4123-8482-A2A796C0A6B0}"
#usecom global IBDA_ConditionalAccess IID_IBDA_ConditionalAccess "{}"
#comfunc global IBDA_ConditionalAccess_get_SmartCardStatus        3 var,var,var,var
#comfunc global IBDA_ConditionalAccess_get_SmartCardInfo          4 var,var,var,var,var,var,var
#comfunc global IBDA_ConditionalAccess_get_SmartCardApplications  5 var,int,var
#comfunc global IBDA_ConditionalAccess_get_Entitlement            6 int,var
#comfunc global IBDA_ConditionalAccess_TuneByChannel              7 int
#comfunc global IBDA_ConditionalAccess_SetProgram                 8 int
#comfunc global IBDA_ConditionalAccess_AddProgram                 9 int
#comfunc global IBDA_ConditionalAccess_RemoveProgram              10 int
#comfunc global IBDA_ConditionalAccess_GetModuleUI                11 int,var
#comfunc global IBDA_ConditionalAccess_InformUIClosed             12 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。