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

IMFMediaKeySession

COM
📘 Microsoft Learn (日本語) · English
IID24fa67d5-d1d0-4dc5-995c-c0efdc191fb5継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

デジタル著作権管理 (DRM) キーシステムとのセッションを表します。

メソッド 5

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

vtbl 3 HRESULT GetError(WORD* code, DWORD* systemCode)

メディアキーセッションに関連付けられたエラー状態を取得します。

codeWORD*outエラーコード。
systemCodeDWORD*outプラットフォーム固有のエラー情報。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 4 HRESULT get_KeySystem(LPWSTR* keySystem)

メディアキーオブジェクトの作成時に使用されたキーシステム名を取得します。

keySystemLPWSTR*outキーシステムの名前。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 5 HRESULT get_SessionId(LPWSTR* sessionId)

このセッション用に作成された一意のセッション ID を取得します。

sessionIdLPWSTR*outメディアキーセッション ID。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 6 HRESULT Update(BYTE* key, DWORD cb)

指定されたキーシステム向けに、Content Decryption Module が必要とする関連データとともにキー値を渡します。

keyBYTE*inサービスから取得したライセンス/キー応答のバイト配列。
cbDWORDinkey のバイト単位のカウント。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 7 HRESULT Close()

メディアキーセッションを閉じます。キーセッションを解放する前に呼び出す必要があります。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMFMediaKeySession "{24FA67D5-D1D0-4DC5-995C-C0EFDC191FB5}"
#usecom global IMFMediaKeySession IID_IMFMediaKeySession "{}"
#comfunc global IMFMediaKeySession_GetError       3 var,var
#comfunc global IMFMediaKeySession_get_KeySystem  4 var
#comfunc global IMFMediaKeySession_get_SessionId  5 var
#comfunc global IMFMediaKeySession_Update         6 var,int
#comfunc global IMFMediaKeySession_Close          7
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。