アプリケーションの依存関係の登録 (Windows Media Format 11 SDK)

[このページに関連付けられている機能である Windows Media Format 11 SDK は、従来の機能です。 ソース リーダーシンク ライターに置き換わりました。 ソース リーダーシンク ライターは、Windows 10とWindows 11用に最適化されています。 Microsoft では、可能であれば、新しいコードで Windows Media Format 11 SDK ではなくソース リーダーシンク ライターを使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

Windows Media Format SDK または Windows メディア プレーヤー SDK によって提供される API を使用するアプリケーションは、これらのテクノロジのランタイム コンポーネントに依存します。 アプリケーションのセットアップの一部として、アプリケーションをこれらのコンポーネントに依存するように登録できます。

アプリケーションを登録するときに、依存関係の 2 つのレベル (ブロックまたは依存) のいずれかを選択できます。 1 つ以上のアプリケーションがいずれかのランタイム コンポーネントに対するブロック依存関係に登録されている場合、コンポーネントは以前のバージョンへのロールバックからブロックされます。 ブロックとして登録されていない依存アプリケーションは、ロールバックをブロックしません。 代わりに、ロールバックが実行される前に、アプリケーションがコンポーネントに依存していることを示すメッセージが表示されます。

アプリケーションを登録するには、アプリケーションを識別する値をレジストリに設定する必要があります。 設定するレジストリ値は、アプリケーションが依存しているコンポーネントによって異なります。 依存関係ごとに 2 つの追加値を設定して、アプリケーションに関する追加情報を提供することもできます。

Windows Media Format SDK ランタイムへの依存を登録するには、次のレジストリ値を使用します。

  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\App、"APP"、"APP_STRING"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\Descriptor、"APP"、"REF_DESCRIPTOR"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\REF_TYPE\Version、"APP"、"WMF_VERSION"

SDK ランタイムへの依存を登録するには、次のレジストリ値Windows メディア プレーヤー使用されます。

  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\App、"APP"、"APP_STRING"
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\Descriptor、"APP"、"REF_DESCRIPTOR"
  • HKEY_CLASSES_ROOT\Software\Microsoft\MediaPlayer\Setup\REF_TYPE\Version、"APP"、"WMP_VERSION"

上記のレジストリ値では、次の変数が使用されます。

REF_TYPE

をブロッキング依存関係の場合は BlockingRefCounts に、非ブロッキング依存関係の場合は DependentRefCounts に置き換えます。

APP

アプリケーションの名前または短い記述子。 この文字列は、ユーザーに表示されるメッセージでは使用されません。 この値は、各ランタイム コンポーネントに関連付けられている 3 つのレジストリ値すべてに使用される識別子です。

APP_STRING

アプリケーションの記述子。 この文字列は、ユーザーに表示されるメッセージで使用できます。

REF_DESCRIPTOR

アプリケーションでコンポーネントを使用する方法の説明。 この値には、最大 256 文字を含めることができます。

WMP_VERSION

アプリケーションで必要なWindows メディア プレーヤーのバージョン。

WMF_VERSION

アプリケーションに必要な Windows Media Format SDK のバージョン。

次の 3 つのレジストリ値の例は、アプリケーションの値を構成する方法を示しています。

  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\App、"SouthridgeVideo"、"Southridge Video Player"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Descriptor、"SouthridgeVideo"、"Southridge Video Player は Windows Media Format SDK を使用してビデオ ファイルを再生します。"
  • HKEY_CLASSES_ROOT\Software\Microsoft\WindowsMedia\Setup\DependentRefCounts\Version、"SouthridgeVideo"、"9.0.0.2600"

プロジェクトに関する考慮事項