IWMPTranscodePolicy
COM公式ドキュメント
IWMPTranscodePolicy インターフェイスは、デジタルメディアファイルの形式変更を管理するために DirectShow ソースフィルターが実装するメソッドを提供します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
allowTranscode メソッドは、Windows Media Player がデジタルメディアコンテンツの形式を Windows Media 形式に変更することを許可されているかどうかを示す値を取得します。
| pvbAllow | VARIANT_BOOL* | inout | トランスコードが許可されているかどうかを示す値を格納する VARIANT_BOOL へのポインター。 |
戻り値
このメソッドは HRESULT を返します。指定可能な値には次の表のものが含まれますが、これらに限定されません。
| 値 | 説明 |
|---|---|
| S_OK | メソッドは成功しました。 |
解説(Remarks)
カスタム形式のデジタルメディアファイルをデバイスにコピーする際、デバイスがそのカスタム形式をサポートしていない場合は、コンテンツの形式を変更する必要があります。この処理はトランスコードと呼ばれます。
デジタルメディアファイルで使用されている形式がサポートされていない場合、Windows Media Player はまず、File Name Extension Registry Settings で説明されているように、トランスコードの許可がレジストリに登録されているかどうかを確認します。カスタム形式の種類にトランスコードの許可が登録されている場合、Windows Media Player はそのカスタム形式に対応する DirectShow ソースフィルターを探し、QueryInterface を呼び出して IWMPTranscodePolicy へのポインターを取得します。インターフェイスポインターが取得されると、Player は IWMPTranscodePolicy::allowTranscode を呼び出します。allowTranscode が VARIANT_TRUE を返した場合、Windows Media Player は必要なトランスコードを実行します。そうでない場合、Windows Media Player はデジタルメディアファイルをデバイスにコピーしません。DirectShow グラフ内のいずれかのフィルターが allowTranscode から VARIANT_FALSE を返した場合、トランスコード操作は失敗します。
Windows Media Player 10 Mobile: このメソッドはサポートされていません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IWMPTranscodePolicy "{B64CBAC3-401C-4327-A3E8-B9FEB3A8C25C}" #usecom global IWMPTranscodePolicy IID_IWMPTranscodePolicy "{}" #comfunc global IWMPTranscodePolicy_allowTranscode 3 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IWMPTranscodePolicy "{B64CBAC3-401C-4327-A3E8-B9FEB3A8C25C}" #usecom global IWMPTranscodePolicy IID_IWMPTranscodePolicy "{}" #comfunc global IWMPTranscodePolicy_allowTranscode 3 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。