DirectXSetupCallbackFunction 関数
DirectXSetupCallbackFunction 関数
オプションでセットアップ プログラムに設定するコールバック関数のプレースホルダ名である。設定されたコールバック関数は、セットアップ プロセスの各ステップごとに一度ずつ呼び出される。
構文
DWORD DirectXSetupCallbackFunction(
DWORD Reason,
DWORD MsgType,
char *szMessage,
char *szName,
void *pInfo
);
パラメータ
- Reason
コールバックの理由。次のいずれかの値を取る。DSETUP_CB_MSG_BEGIN_INSTALL
DirectXSetup が Microsoft® DirectX コンポーネントのインストールを開始しようとしている。DirectX のバージョン、オペレーティング システム、システム言語、必要なディスク容量に関して、システムがチェックされる。DSETUP_CB_MSG_BEGIN_INSTALL_RUNTIME
DirectXSetup が DirectX コンポーネントのインストールを開始しようとしている。DSETUP_CB_MSG_INTERNAL_ERROR
内部エラーが発生した。DirectX コンポーネントまたはデバイス ドライバのセットアップが失敗した。DSETUP_CB_MSG_NOMESSAGE
表示するメッセージがない。コールバック関数は戻らなければならない。DSETUP_CB_MSG_PROGRESS
ランタイム インストールの進行状況をレポートする。DirectSetup ファイルの初期化、抽出、コピー、完了などについてレポートされる。DSETUP_CB_MSG_WARNING_DISABLED_COMPONENT
DirectSetup が、1 つまたは複数の DirectX コンポーネントが無効になっていることを検出した。
- MsgType
メッセージ ボックスの表示を制御するフラグ。これらのフラグは、uType パラメータとして MessageBox 関数に渡すことができる。MsgType が 0 のときは例外で、セットアップ プログラムはステータス情報を表示できるが、ユーザーからの入力待ちをしてはいけない。 - szMessage
エラー メッセージまたはステータス メッセージが含まれたローカライズ文字列へのポインタ。 これらの文字列は、MessageBox 関数で作成されるダイアログ ボックスに表示できる。 - szName
NULL にすれば無視される。 - pInfo
アップグレード情報を含む構造体のアドレスへのポインタ。Reason が DSETUP_CB_MSG_PROGRESS の場合、セットアップ プログラムが現在のインストール状況を伝える。この場合、インストールの過程情報を含む DSETUP_CB_PROGRESS 構造体をポイントする pInfo である。
戻り値
1 つの例外を除いて、戻り値は MessageBox 関数から返される戻り値と同じでなければならない。この関数が 0 を返した場合、DirectXSetup 関数は デフォルトの動作で DirectX コンポーネントまたはドライバのアップグレードを実行する。
注意
DirectXSetupCallbackFunction の名前はセットアップ プログラムから与えられる。DirectXSetupSetCallback 関数は、DirectSetup にコールバック関数のアドレスを渡す際に使われる。
MsgType が 0 の場合、セットアップ プログラムはステータス情報を表示できるが、ユーザーからの入力待ちをしてはいけない。この場合、関数は IDOK を返す。
Reason が DSETUP_CB_MSG_WARNING_DISABLED_COMPONENT の場合、DirectX コンポーネントを有効にする方法の詳細について DirectX Diagnostic Tool を参照すること。通常、Microsoft Direct3D® などのコンポーネントが Microsoft Windows® サーバーで無効となる。
関数の情報
| ヘッダー | dsetup.h |
| インポート ライブラリ | なし |
| 最低限のオペレーティング システム | Windows 98 |
参照