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

IMFMediaKeySessionNotify

COM
📘 Microsoft Learn (日本語) · English
IID6a0083f9-8947-4c1d-9ce0-cdee22b23135継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

メディアキーセッションに関する情報をアプリに通知するための仕組みを提供します。

メソッド 3

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

vtbl 3 void KeyMessage(LPWSTR destinationURL, BYTE* message, DWORD cb)

アプリケーションがキーの取得を開始できるように情報を渡します。

destinationURLLPWSTRinoptionalメッセージの送信先 URL。
messageBYTE*inアプリケーションに送信するメッセージ。
cbDWORDinmessage のバイト単位の長さ。
vtbl 4 void KeyAdded()

キーが追加されたことをアプリケーションに通知します。

解説(Remarks)

KeyAdded は、セッションに対して要求されたキーがすでに取得されている場合にも呼び出されることがあります。

vtbl 5 void KeyError(WORD code, DWORD systemCode)

キーの処理中にエラーが発生したことをアプリケーションに通知します。

codeWORDin発生したキーエラーのコードを示すWORD。MF_MEDIAKEYSESSION_ERROR値。
systemCodeDWORDinプラットフォーム固有のシステムエラーコードを示すDWORD。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMFMediaKeySessionNotify "{6A0083F9-8947-4C1D-9CE0-CDEE22B23135}"
#usecom global IMFMediaKeySessionNotify IID_IMFMediaKeySessionNotify "{}"
#comfunc global IMFMediaKeySessionNotify_KeyMessage  3 wstr,var,int
#comfunc global IMFMediaKeySessionNotify_KeyAdded    4
#comfunc global IMFMediaKeySessionNotify_KeyError    5 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。