ゲーム開発者向けの Direct3D 11 展開

[アーティクル]
2023/06/13

この記事では、必要に応じて Direct3D 11 コンポーネントをシステムに展開する方法について説明します。

概要
Direct3D 11.3
Direct3D 11.2
Direct3D 11.1
D3D11InstallHelper.dll
D3D11Install.exe
インストール・プログラムへの統合
- InstallShield への統合
- MSI パッケージへの統合
デバッグのヒント
企業用の設定
関連記事

概要

Direct3D 11 API は、マルチスレッドレンダリングとリソース作成、コンピューティングシェーダー、ハードウェアテセレーション、BC6H/BC7 テクスチャ圧縮、HLSL シェーダーモデル 5.0 と動的シェーダーリンケージをサポートする既存の Direct3D 10.1 API を拡張します。 Direct3D 11 コンポーネントに加えて、DirectX 11 ランタイムには、Direct3D 11、DXGI 1.1、10level9 機能レベル、WARP10 ソフトウェアレンダリングデバイス、Direct2D、DirectWrite、および 10level9 および WARP10 をサポートする更新された Direct3D 10.1 という追加のグラフィックスコンポーネントが含まれています。これらおよびその他の Windows グラフィックスコンポーネントの詳細については、「 Windows のグラフィックス API」を参照してください。

これらの新しいグラフィックスコンポーネントはすべて、Windows 7 および Windows Server 2008 R2 オペレーティングシステムに組み込まれています。 Direct3D 11 API および関連コンポーネントは、Windows Updateからのシステム更新プログラムを使用して Windows Vista にインストールすることもできます。この更新プログラムには、Windows Vista と Service Pack 2 が必要です。自動更新が有効になっているエンドユーザーは、すべての Windows 7 ユーザーと同様に、Direct3D 11 コンポーネントが既にインストールされている可能性があります。

D3D11InstallHelper サンプルは、Direct3D 11 API の検出を簡略化し、エンドユーザーのコンピューターに該当する場合はシステム更新プログラムを自動的にインストールし、新しい Service Pack が必要な場合は手動でエンドユーザーに適切なメッセージを提供するように設計されています。

注意

HLSL コンパイラ (D3DCompile*.dll) と Direct3D 11 (D3DX11*.dll) 用の D3DX ユーティリティライブラリは、Windows オペレーティングシステムのどのバージョンにも組み込まれていませんが、既存の DirectSetup テクノロジを使用してアプリケーションのインストーラーの一部として展開できます。DirectSetup の使用方法の詳細については、「ゲーム開発者向けの DirectX インストール」を参照してください。 "Effects 11" は、 Direct3D 11 Update の Effects で共有ソースサポートライブラリとして使用でき、アプリ (DXUT ユーティリティライブラリと同様) に直接含めることができます。したがって、ランタイム再配布の追加要件はありません。

Direct3D 11.3

Windows 10には、Direct3D 11.3 API が組み込まれています。 Direct3D 11.3 API の新機能の一覧については、「Direct3D 11.3 の機能」を参照してください。

Direct3D 11.2

Windows 8.1とWindows Server 2012 R2 には、Direct3D 11.2 API が組み込まれています。 Direct3D 11.2 API の新機能の一覧については、「Direct3D 11.2 の機能」を参照してください。

Direct3D 11.1

Windows 8とWindows Server 2012には、Direct3D 11.1 API が組み込まれています。 Direct3D 11.1 API の部分的なサポートは、Windows 7 用プラットフォーム更新プログラムがインストールされた Windows 7 または Windows Server 2008 R2 で利用できます。 Windows 7 のプラットフォーム更新プログラムの詳細については、「Windows 7 用プラットフォーム更新プログラム」を参照してください。

D3D11InstallHelper.dll

D3D11InstallHelper.dllは、Direct3D 11 コンポーネントを検出し、必要に応じてWindows Update サービスを介してシステム更新を実行するためのコア機能をホストします。 DLL には、メッセージやダイアログボックスは直接表示されません。

DLL は、次のエントリポイントで構成されます。

CheckDirect3D11Status

この関数は、必要なチェックを実行し、このコンピューターの Direct3D 11 の状態を返します。この関数には管理者権限は必要ありません。

D3D11IH_STATUS_INSTALLEDの状態は、Direct3D 11 がコンピューターに既にインストールされており、使用できる状態であることを示します。
D3D11IH_STATUS_NOT_SUPPORTEDは、このバージョンの Windows で Direct3D 11 または関連テクノロジがサポートされていないことを示します。
D3D11IH_STATUS_NEED_LATEST_SPの状態は、ユーザーが最新の Windows Vista Service Pack をインストールする必要があることを示します。
最後に、D3D11IH_STATUS_REQUIRES_UPDATEの状態は、システムに Direct3D 11 がインストールされていないが、システム更新プログラムがこのバージョンの Windows に適用されることを示します。

DoUpdateForDirect3D11

この関数は、Windows Update API を使用して、このシステムに Direct3D 11 をインストールするためのシステム更新プログラムを実行します (該当する場合)。この関数では、Windows Updateを成功させるためにネットワーク接続と管理者権限が必要であることに注意してください。省略可能な進行状況コールバック関数とユーザーコンテキストポインターを受け取り、完了すると最終的な結果コードを返します。

D3D11IH_RESULT_SUCCESS結果は、システム更新プログラムが適用され、使用できる状態であることを示します。一方、D3D11IH_RESULT_SUCCESS_REBOOTは、システム更新プログラムが完了する前にコンピューターを再起動する必要があることを示します。この関数は、システムの再起動をスケジュールしないことに注意してください。
D3D11IH_RESULT_NOT_SUPPORTEDは、システム更新プログラムがこのバージョンの Windows に適用されないことを示します。この結果は、この関数が CheckDirect3D11Status からD3D11IH_STATUS_REQUIRES_UPDATE状態を取得した後にのみ呼び出される場合は発生しません。
D3D11IH_RESULT_UPDATE_NOT_FOUNDの結果は、Windows Update サーバーでシステム更新プログラムパッケージが見つからなかったことを示します。
Windows Updateのダウンロードまたはインストールが失敗した場合は、結果としてD3D11IH_RESULT_UPDATE_DOWNLOAD_FAILEDまたはD3D11IH_RESULT_UPDATE_INSTALL_FAILEDが返されます。
Windows Update API からネットワーク接続エラーが返された場合、D3D11IH_RESULT_WU_SERVICE_ERROR結果が返され、問題が断続的であるか、ネットワーク構成またはファイアウォール設定に関連している可能性があることを示します。更新関数をもう一度試しても成功する可能性があります。

Windows Update API の詳細については、「Windows Update エージェント API」を参照してください。

D3D11Install.exe

注意

D3D11Install.exeを実行するにはD3D11InstallHelper.dllが必要です。

D3D11Install.exeは、D3D11InstallHelper.dllを UI メッセージとエンドユーザーメッセージを含むスタンドアロンインストーラーとして使用し、DLL を適切に使用するための例として機能するためのツールです。 Direct3D 11 が既にインストールされている場合、システム更新プログラムがシステムの再起動を必要とせずに正常に適用された場合、Service Pack のインストールが必要な場合、または Direct3D 11 がこのコンピューターでサポートされていない場合、プロセスは 0 で終了します。システム更新が正常に適用され、システムの再起動が完了する必要がある場合は、1 が返されます。他のエラー条件に対して 2 が返されます。この実行可能ファイルを実行するには管理者権限が必要であり、UAC が有効になっている Windows Vista または Windows 7 で実行するときに昇格を要求するマニフェストがあることに注意してください。 D3D11Install.exeは、Direct3D 11 更新プログラムを展開するためのスタンドアロンツールとして使用することも、インストーラーによって直接使用することもできます。

次のコマンドラインスイッチがサポートされています。

/静か: メッセージ、プロンプト、進行状況ダイアログボックス、またはエラーメッセージを表示しません。
/パッシブ: メッセージ、プロンプト、またはエラーメッセージは表示されませんが、進行状況ダイアログボックスが表示されます。
/最小限: 最小限のプロンプトのみを表示します。
/Y: 必要に応じて、標準インストールと最小インストールの更新プログラムのインストールを確認するように求めるメッセージが表示されないようにします。
/langid decimal: エンドユーザーメッセージとダイアログボックスリソースを表示するときに使用する言語識別子コードを強制します。既定値は 1024 で、システムの既定の言語設定が使用されます。
/呉: マネージドサーバーまたはその他の標準以外の構成で実行されているWindows Server Update Services (WSUS) である可能性がある、システムの既定値ではなく、Windows Updateを強制的に使用します。

インストール・プログラムへの統合

Windows 版ゲームのサポートの簡単なインストール、技術的要件 3.1 に準拠するには、インストールプロセスの早い段階でエンドユーザープロンプトが表示されるように注意し、UAC 関連の昇格プロンプトが複数ないように注意する必要があります。この目標を達成するには、次の 3 つの基本的な選択肢があります。

最も基本的な方法は、コマンドラインスイッチ /minimal を使用してD3D11Install.exeを実行することです。これはインストーラー Q&A の早い段階で行う必要があり、インストールでは戻り値 1 を使用して、インストールの終了時に再起動をスケジュールする必要があることを示す必要があります。プログラムを実行するには管理者権限が必要です。
D3D11InstallHelper.dllを直接使用して、更新の必要性を検出し、状態D3D11IH_STATUS_NEED_LATEST_SPに必要なすべてのエンドユーザーメッセージを提供します。この場合、解決には手動でのユーザー操作が必要です。 D3D11IH_STATUS_NOT_SUPPORTEDの状態の結果を使用して、Direct3D 11 関連の資産のインストールを制御したり、Direct3D 11 専用アプリケーションのエラー条件として使用したりできますが、それ以外の場合は有用なエンドユーザーメッセージであるとは限りません。状態D3D11IH_STATUS_REQUIRES_UPDATEの場合、インストーラーは DLL エントリポイント DoUpdateForDirect3D11 を直接使用して更新を実行し、結果として得られるさまざまなエンドユーザーメッセージを処理できます。標準メッセージの例は、[D3D11Install.exe] ダイアログボックスと文字列テーブルリソースを調べることで確認できます。更新エントリポイントには管理者権限が必要です。
ハイブリッドアプローチでは、D3D11InstallHelper.dllを使用して状態をチェックし、状態コードD3D11IH_STATUS_NEED_LATEST_SPまたはD3D11IH_STATUS_REQUIRES_UPDATEの場合は、スイッチ /minimal と /y を使用してD3D11Install.exeを実行して、ダイアログボックスを表示したり、必要に応じて更新を実行したりできます。これらの手順は、インストールプロセスの早い段階 (通常は Q&A の直後) に実行する必要があり、実行可能ファイルを実行するには管理者権限が必要です。

InstallShield への統合

InstallShield の InstallScript からの Direct3D 11 展開の処理は、D3D11InstallHelper サンプルを使用して簡単に行うことができます。 InstallScript を使用して InstallShield と統合するために必要な手順は次のとおりです (前のセクションで説明した方法 3 を使用)。

InstallShield エディターで InstallScript プロジェクトを開きます。
D3D11InstallHelper.dllとD3D11Install.exeを サポートファイルのプロジェクトに追加します。

InstallShield プロジェクトにファイルを追加するには
1. [インストール Designer] タブで、左側のナビゲーションウィンドウの [動作とロジック] の下にある [ファイル/ビルボードのサポート] をクリックします。
2. [ 言語に依存しない] をクリックし、[ ファイル ] ウィンドウで右クリックし、[ ファイルの挿入] を選択します。参照してD3D11InstallHelper.dllとD3D11Install.exeを追加します。これらのファイルの既定の場所は、SDK root\Samples\C++\Misc\Bin\x86 です。
InstallScript エクスプローラーで、左側のナビゲーションウィンドウの [ 動作とロジック ] の下にある DLL または実行可能ファイルを呼び出す InstallScript ファイル (通常は Setup.rul) をクリックします。
次の InstallScript を上部付近のファイルに貼り付けます。

#define D3D11IH_STATUS_INSTALLED 0 #define D3D11IH_STATUS_NOT_SUPPORTED 1 #define D3D11IH_STATUS_REQUIRES_UPDATE 2 #define D3D11IH_STATUS_NEED_LATEST_SP 3 #define D3D11IH_STATUS_ERROR -1 プロトタイプ NUMBER D3D11InstallHelper.CheckDirect3D11StatusIS();

#define D3D11IH_RESULT_SUCCESS 0 #define D3D11IH_RESULT_SUCCESS_REBOOT 1 #define D3D11IH_RESULT_NOT_SUPPORTED 2 #define D3D11IH_RESULT_UPDATE_NOT_FOUND 3 #define D3D11IH_RESULT_UPDATE_DOWNLOAD_FAILED 4 #define D3D11IH_RESULT_UPDATE_INSTALL_FAILED 5 #define D3D11IH_RESULT_WU_SERVICE_ERROR 6 #define D3D11IH_RESULT_ERROR -1 プロトタイプ NUMBER D3D11InstallHelper.DoUpdateForDirect3D11IS(BOOL);```

OnFirstUIBefore 関数のファイルに、戻り値 0 の直前に次の InstallScript を貼り付けます。

Dlg_D3D11:
    UseDLL( SUPPORTDIR ^ "D3D11InstallHelper.DLL" );
    nResult = D3D11InstallHelper.CheckDirect3D11StatusIS();   
    UnUseDLL( SUPPORTDIR ^ "D3D11InstallHelper.DLL" );

    if ( nResult = D3D11IH_STATUS_REQUIRES_UPDATE
         || nResult = D3D11IH_STATUS_NEED_LATEST_SP) then
        nResult = LaunchAppAndWait(
SUPPORTDIR^"D3D11Install.exe",
"/minimal /y", WAIT);
        if ( nResult < 0 ) then
            MessageBox("Unable to launch D3D11Install.exe",
 SEVERE);
        elseif ( nResult == 1 ) then
            BATCH_INSTALL = 1;
        endif;          
    endif;

MSI パッケージへの統合

MSI カスタムアクションを使用して Direct3D 11 展開を統合するために必要な手順の概要を次に示します (このトピックで前述した方法 3 を使用)。

インストール時にD3D11Install.exeとD3D11InstallHelper.dllへの相対パスを含む RelativePathToD3D11IH という名前の MSI Property テーブルにプロパティを追加します (これは通常、メディアイメージ内にあります)。これにより、MSI プロパティD3D11IH_STATUS CheckDirect3D11Status によって返される状態 (列挙記号または "ERROR" と等しい文字列プロパティ) も設定されます。
CostFinalize アクションの後、D3D11InstallHelper.dll関数 SetD3D11InstallMSIProperties を 即時カスタムアクションとして呼び出して、他のカスタムアクションに適切な MSI プロパティを設定します。
インストール時に、D3D11InstallHelper.dll関数 DoD3D11InstallUsingMSI を呼び出す InstallFiles アクションの後に、遅延カスタムアクションをトリガーします。カスタムアクションでは、昇格されたコンテキストで実行される msidbCustomActionTypeNoImpersonate フラグを設定する必要があります。
InstallFinalize アクションの後、必要に応じて、再起動要求の結果コードの成功を処理する即時カスタムアクションとして、 D3D11InstallHelper.dll関数 FinishD3D11InstallUsingMSI を呼び出します。

この手順については、次の手順で詳しく説明します。この手順では、 Orca エディターなどの MSI エディターを使用して実行できるプロセスについて説明します。一部の MSI エディターには、これらの構成手順の一部を簡略化するウィザードがあります。

D3D11InstallHelper.dllと統合するために MSI パッケージを構成するには

Orca で MSI パッケージを開きます。
次の表に示す行を、MSI パッケージの Binary テーブルに追加します。

名前 Data

D3D11IH DLL\D3D11InstallHelper.dllへのファイルパス

注意

このファイルは MSI パッケージに埋め込まれるので、D3D11InstallHelper.dll再コンパイルするたびにこの手順を実行する必要があります。

名前	Data
D3D11IH	DLL\D3D11InstallHelper.dllへのファイルパス

次の表に示す行を、MSI パッケージの CustomAction テーブルに追加します。

アクション	Type	source	移行先
Direct3D11SetProps	msidbCustomActionTypeDll + msidbCustomActionTypeBinaryData + msidbCustomActionTypeContinue = 65	D3D11IH	SetD3D11InstallMSIProperties
Direct3D11DoInstall	msidbCustomActionTypeDll + msidbCustomActionTypeBinaryData + msidbCustomActionTypeContinue + msidbCustomActionTypeInScript + msidbCustomActionTypeNoImpersonate = 3137	D3D11IH	DoD3D11InstallUsingMSI
Direct3D11Finish	msidbCustomActionTypeDll + msidbCustomActionTypeBinaryData + msidbCustomActionTypeContinue = 65	D3D11IH	FinishD3D11InstallUsingMSI

次の表の Action、Condition、Sequence に表示される値を、MSI パッケージの InstallExecuteSequence テーブルに追加します。

アクション	条件	シーケンス	メモ
Direct3D11SetProps		1016	シーケンス番号は、CostFinalize の直後にアクションを配置します。
Direct3D11DoInstall	NOT Installed	4004	このカスタムアクションは、すべてのユーザーの新しいインストール中にのみ行われます。シーケンス番号は、InstallFiles の後とロールバック後にアクションを配置します。
Direct3D11Finish		6615	シーケンス番号は、InstallFinalize の直後にアクションを配置します。

次の表に示す行を、MSI パッケージの Property テーブルに追加します。

プロパティ値

RelativePathToD3D11IH D3D11Install.exeとD3D11InstallHelper.dllを含む相対ファイルパス

注意

パスで指定された場所は、インストールパスで指定された場所 ("redist\" など) に対する相対位置です。
MSI パッケージを保存します。 MSI パッケージと Windows インストーラーの詳細については、「 Windows インストーラー」を参照してください。

プロパティ	値
RelativePathToD3D11IH	D3D11Install.exeとD3D11InstallHelper.dllを含む相対ファイルパス

デバッグのヒント

D3D11InstallHelper.dllとD3D11Install.exeの両方を Visual Studio のデバッグ構成でビルドできます。これらのバージョンでは、標準の Windows デバッグ出力メカニズムにメッセージが出力されます。

企業用の設定

D3D11InstallHelper サンプルは、コンシューマーによるゲームのインストールに最も一般的なシナリオである、Windows Updateを使用した標準的な展開用に設計されています。ただし、パブリッシャーや開発スタジオで作業する多くのゲーム開発者は、Windows Server Update Services (WSUS) テクノロジを使用してソフトウェア更新プログラムを提供するローカル管理サーバーを持つエンタープライズ設定で行います。この種類の環境では、ローカルの IT 管理者は、企業ネットワーク内のコンピューターで使用できる更新プログラムを承認制御でき、標準のコンシューマーバージョンの更新プログラム KB 971644は使用できません。

企業/エンタープライズ設定で DirectX 11 を展開するための 3 つの基本的なソリューションがあります。

一部の構成では、ローカルで管理されている WSUS サーバーを使用するのではなく、直接チェック Windows Updateできます。このため、D3D11InstallHelper では /wu コマンドラインスイッチがサポートされています。ただし、すべての企業ネットワークでパブリック Microsoft サーバーへの接続が許可されているわけではありません。
ローカル IT 管理者は、DIRECT3D 11 API を含む、WSUS から展開されたエンタープライズでサポートされる更新プログラムである KB 971512を承認できます。これは、標準ユーザーが完全にロックダウンされている環境で Direct3D 11 更新プログラムを取得するための唯一のオプションです。
または、 KB 971512 を手動でインストールすることもできます。

ゲーマーのコンピューターがローカルで管理されている WSUS サーバーからのみ更新プログラムを取得できることは非常にまれであり、このような環境にある可能性が高いのは大規模な組織の開発者のみです。

ゲーム開発者向けの Windows ファイアウォール

ゲーム開発者向けの Windows ゲームエクスプローラー

次の方法で共有

ゲーム開発者向けの Direct3D 11 展開

概要

Direct3D 11.3

Direct3D 11.2

Direct3D 11.1

D3D11InstallHelper.dll

D3D11Install.exe

インストール・プログラムへの統合

InstallShield への統合

MSI パッケージへの統合

デバッグのヒント

企業用の設定

フィードバック

その他のリソース

次の方法で共有

ゲーム開発者向けの Direct3D 11 展開

概要

Direct3D 11.3

Direct3D 11.2

Direct3D 11.1

D3D11InstallHelper.dll

D3D11Install.exe

インストール・プログラムへの統合

InstallShield への統合

MSI パッケージへの統合

デバッグのヒント

企業用の設定

関連記事

フィードバック

その他のリソース