Platform SDK: DirectX

DirectXSetup

DirectXSetup 関数は、1 つまたは複数の DirectX コンポーネントをインストールする。

int WINAPI DirectXSetup(
  HWND  hWnd,          
  LPSTR lpszRootPath,  
  DWORD dwFlags        
);

パラメータ

hWnd
セットアップ ダイアログ ボックスの親ウィンドウのハンドル。
lpszRootPath
DirectX コンポーネント ファイルのルート パスを含む文字列のアドレス。この文字列には、ファイル dsetup.dll および dsetup.dll32 と、再配布可能ファイルを格納した「DirectX」 (大文字小文字の区別なし) ディレクトリのあるディレクトリへのフル パスを指定しなければならない。この値が NULL の場合は、現在の作業ディレクトリが使用される。
dwFlags
インストール対象となる DirectX コンポーネントを示す 1 つまたは複数のフラグ。推奨は、フル インストール (DSETUP_DIRECTX)。
DSETUP_D3D 使用しない。このフラグを使用する DirectX 3 のプログラムはすべての DirectX コンポーネントをインストールする。
DSETUP_DDRAW 使用しない。このフラグを使用する DirectX 3 のプログラムはすべての DirectX コンポーネントをインストールする。
DSETUP_DDRAWDRV DirectX 7.0 では使用しない。
DSETUP_DINPUT 使用しない。このフラグを使用する DirectX 3 のプログラムはすべての DirectX コンポーネントをインストールする。
DSETUP_DIRECTX DirectX と互換性のあるディスプレイ ドライバおよびオーディオ ドライバに加え、DirectX ランタイム コンポーネントをインストールする。
DSETUP_DIRECTXSETUP 使用しない。このフラグを使用する DirectX 3 のプログラムはすべての DirectX コンポーネントをインストールする。
DSETUP_DPLAY 使用しない。このフラグを使用する DirectX 3 のプログラムはすべての DirectX コンポーネントをインストールする。
DSETUP_DPLAYSP 使用しない。このフラグを使用する DirectX 3 のプログラムはすべての DirectX コンポーネントをインストールする。
DSETUP_DSOUND 使用しない。このフラグを使用する DirectX 3 のプログラムはすべての DirectX コンポーネントをインストールする。
DSETUP_DSOUNDDRV DirectX 7.0 では使用しない。
DSETUP_DXCORE DirectX ランタイム コンポーネントをインストールする。DirectX と互換性のあるディスプレイ ドライバとオーディオ ドライバはインストールしない。
DSETUP_TESTINSTALL インストール内容をテストする。新しいコンポーネントをインストールすることはない。
DSETUP_USEROLDERFLAG -14 を返せる。これは、インストールされている DirectX のバージョンがインストールするバージョンよりも新しいことを意味する。

戻り値

成功すれば DSETUPERR_SUCCESS または DSETUPERR_SUCCESS_RESTART (変更内容を有効にするためにシステムを再起動する必要がある場合) を返す。失敗すればエラー コードを返す。戻り値については、「戻り値」を参照すること。

注意

セットアップ プログラムで DirectXSetup 関数を使用する前に、システムに最低 15 MB の空きディスク領域があることを確認すること。これは適切なファイルをセット アップするために DirectX が必要とする最大領域である。ただし、システムに DirectX ファイルが既に存在する場合は必要ない。

動作環境

  Windows NT/2000 : Service Pack 3 を適用した Windows NT バージョン 4.0 以降が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsetup.h で宣言。
  インポート ライブラリ : dsetup.lib を使用。