Dinstall Sample

This sample uses DirectSetup functions to install the DirectX subsystem. It shows how to use a callback function to present messages and get user input through a custom interface (a modeless dialog box).

Path

User's Guide

1. Copy the entire contents of the \Redist folder from the DirectX SDK CD into the same folder as Dinstall.exe.
2. In your development environment, set the working directory to this folder as well. (In Microsoft Visual C++, this setting is on the Debug page of the Project Settings dialog box.)
3. Run the program and, on the File menu, click Start Install. DirectSetup performs a simulated installation of DirectX (see Programming Notes below) and advises you of its progress in a modeless dialog box. You can use the Options menu to change the level of messages shown. However, if you are performing only a simulated installation, you will never see problem or update messages.
4. On the File menu, click GET Version. The program shows the version and revision number of DirectX currently installed on the system.

Programming Notes

By default, the program passes DSETUP_TESTINSTALL to the DirectXSetup function. This means that no files are copied and the registry is not modified. To perform a real installation, delete this flag from the call.

Dinstall.exe employs a callback function to monitor the progress of installation and intercept messages. Depending on the user's preferred warning level, as tracked in g_fStatus, messages may be ignored or presented to the user in a modeless dialog box. If user input is required, the appropriate buttons are displayed and the application monitors the message queue until one of the buttons is pressed.

Although DirectX samples include Visual C++ project workspace files, you might need to verify other settings in your development environment to ensure that the samples compile properly.

See Also

Installing DirectX with DirectSetup