Platform SDK: DirectX |
The DirectXSetup function installs one or more DirectX components.
int WINAPI DirectXSetup( HWND hWnd, LPSTR lpszRootPath, DWORD dwFlags );
DSETUP_D3D | Obsolete. DirectX 3 programs that use this flag install all DirectX components. |
DSETUP_DDRAW | Obsolete. DirectX 3 programs that use this flag install all DirectX components. |
DSETUP_DDRAWDRV | Not used in DirectX 7.0. |
DSETUP_DINPUT | Obsolete. DirectX 3 programs that use this flag install all DirectX components. |
DSETUP_DIRECTX | Installs DirectX run-time components, as well as DirectX-compatible display and audio drivers. |
DSETUP_DIRECTXSETUP | Obsolete. DirectX 3 programs that use this flag install all DirectX components. |
DSETUP_DPLAY | Obsolete. DirectX 3 programs that use this flag install all DirectX components. |
DSETUP_DPLAYSP | Obsolete. DirectX 3 programs that use this flag install all DirectX components. |
DSETUP_DSOUND | Obsolete. DirectX 3 programs that use this flag install all DirectX components. |
DSETUP_DSOUNDDRV | Not used in DirectX 7.0. |
DSETUP_DXCORE | Installs DirectX run-time components. Does not install DirectX-compatible display and audio drivers. |
DSETUP_TESTINSTALL | Performs a test installation. Does not install new components. |
DSETUP_USEROLDERFLAG | Enables the return of –14, which means that the installed version of DirectX is newer than the version being installed. |
If this function succeeds, it returns DSETUPERR_SUCCESS, or DSETUPERR_SUCCESS_RESTART if the user must restart the system for changes to take effect.
If it fails, it returns an error value. For a list of possible return values, see Return Values.
Before using the DirectXSetup function in your setup program, ensure that there is at least 15 MB of available disk space on the system. This is the maximum space required for DirectX to set up the appropriate files. If the system already contains the DirectX files, this space is not needed.
Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in Dsetup.h.
Import Library: Use Dsetup.lib.