ホーム › Media.WindowsMediaFormat › IWMProfileManager2

IWMProfileManager2

COM

📘 Microsoft Learn (日本語) · English

IID7a924e51-73c1-494d-8019-23d37ed9b89a継承元IWMProfileManager自前メソッド開始 vtbl9

公式ドキュメント

IWMProfileManager2 インターフェイスは、プロファイルマネージャーが列挙するシステムプロファイルのバージョン番号を指定および取得するためのメソッドを追加します。

メソッド 2

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

vtbl 9 HRESULT GetSystemProfileVersion(WMT_VERSION* pdwVersion)

GetSystemProfileVersion メソッドは、プロファイルマネージャーが列挙するシステムプロファイルのバージョン番号を取得します。

pdwVersion

WMT_VERSION*

inout

WMT_VERSION 列挙型のいずれか 1 つのメンバーへのポインター。

戻り値

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

解説(Remarks)

Windows Media 9 シリーズのコーデック用のシステムプロファイルは存在しないため、このメソッドは主に、Windows Media 9 シリーズのコーデックを使用してカスタムプロファイルに変換するためのバージョン 8 のシステムプロファイルを取得する場合に役立ちます。詳細については、Reusing Stream Configurations を参照してください。

vtbl 10 HRESULT SetSystemProfileVersion(WMT_VERSION dwVersion)

SetSystemProfileVersion メソッドは、プロファイルマネージャーが列挙するシステムプロファイルのバージョン番号を指定します。

dwVersion

WMT_VERSION

WMT_VERSION 列挙型のいずれか 1 つのメンバー。

戻り値

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

解説(Remarks)

WMT_VER_4_0 は下位互換性のためだけの既定値であるため、必要な場合は必ずより新しいバージョンに設定してください。通常は、独自の Windows Media 9 シリーズプロファイルを作成するための出発点として使用するバージョン 8 のプロファイルを取得するために、これを WMT_VER_8_0 に設定します。WMT_VER_9_0 に設定した場合、列挙されるプロファイルは 0 個になります。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWMProfileManager2 "{7A924E51-73C1-494D-8019-23D37ED9B89A}"
#usecom global IWMProfileManager2 IID_IWMProfileManager2 "{}"
#comfunc global IWMProfileManager2_GetSystemProfileVersion  9 var
#comfunc global IWMProfileManager2_SetSystemProfileVersion  10 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IWMProfileManager2 "{7A924E51-73C1-494D-8019-23D37ED9B89A}"
#usecom global IWMProfileManager2 IID_IWMProfileManager2 "{}"
#comfunc global IWMProfileManager2_GetSystemProfileVersion  9 sptr
#comfunc global IWMProfileManager2_SetSystemProfileVersion  10 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。