ConvertPluginCLSID サブキー

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能な場合は SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

Windows メディア プレーヤー 11 でカスタム ファイル名拡張子が検出されると、拡張機能と一致するレジストリ サブキーが検索されます。 サブキーについては、「 ファイル名拡張子レジストリの設定」を参照してください。 場合によっては、拡張機能のサブキーに ConvertPluginCLSID という名前のサブキーがあります。

たとえば、カスタム ファイル形式 (ファイル名拡張子 .xyz) と、ファイルを Windows メディア プレーヤー でサポートされている形式に変換する変換プラグインを作成したとします。次に、プラグインのクラス ID を次のサブキーの一方または両方に格納します。

HKEY_LOCAL_MACHINE\Software\Microsoft\Multimedia\WMPlayer\Extensions\.xyz\ConvertPluginCLSID

HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Player\Extensions\.xyz\ConvertPluginCLSID

ConvertPluginCLSID サブキーは、メディア ファイルをカスタム形式から Player でサポートされている形式に変換するために使用Windows メディア プレーヤープラグインのクラス ID を指定します。

ConvertPluginCLSID サブキーには、次のエントリがあります。

  • 既定の変換プラグインを表す既定のエントリ。
  • 既定の変換プラグインを表す名前付きエントリ。
  • 代替変換プラグインを表す追加の名前付きエントリ。

たとえば、カスタム ファイル形式に既定の変換プラグインと 2 つの代替変換プラグインがあるとします。 ConvertPluginCLSID サブキーの下のレジストリ エントリは、次の形式になります。

名前 Type 値
Default REG_SZ 既定の変換プラグインのレジストリ形式のクラス ID。
既定の変換プラグインのレジストリ形式のクラス ID。 REG_SZ 既定の変換プラグインのフレンドリ名。
最初の代替変換プラグインのクラス ID (レジストリ形式)。 REG_SZ 最初の代替変換プラグインのフレンドリ名。
2 番目の代替変換プラグインのクラス ID (レジストリ形式)。 REG_SZ 2 番目の代替変換プラグインのフレンドリ名。

 

既定の変換プラグインは、既定のエントリと名前付きエントリの 2 つのレジストリ エントリによって表されることに注意してください。 Windows メディア プレーヤーは、既定のエントリを使用して、既定の (プライマリ) 変換プラグインであるプラグインを決定します。 Windows メディア プレーヤーでは、名前付きエントリを使用して、既定のプラグインを含むすべての変換プラグインのフレンドリ名を取得します。

変換プラグインのフレンドリ名は、プラグインを作成する会社によって決まります。 Windows メディア プレーヤーは、ユーザー インターフェイスにフレンドリ名を表示する場合があります。

Windows メディア プレーヤーがカスタム形式から標準形式にファイルを変換しようとすると、最初に既定のプラグインが読み込まれます。 既定のプラグインがファイルの変換に失敗し、NS_E_WMP_CONVERT_PLUGIN_UNKNOWN_FILE_OWNERを返した場合、プレーヤーは、変換が成功するか、試すプラグインがなくなったら、各代替プラグインを読み込みます。 ファイル名拡張子に変換プラグインが見つからない場合、プレーヤーは警告メッセージを表示しません。

ConvertPluginCLSID レジストリエントリは、Windows メディア プレーヤー 11 でサポートされています。

ファイル名拡張子レジストリ設定

Windows メディア プレーヤー変換プラグイン