DirectXSetup 함수

1 개 또는 복수의 Microsoft® DirectX® 구성 요소를 인스톨 한다.

구문

int DirectXSetup(      

    HWND hWnd,
    LPSTR lpszRootPath,
    DWORD dwFlags
);

파라미터

hWnd

셋업 다이알로그 박스의 부모 윈도우의 핸들.

lpszRootPath

DirectX 구성 요소 파일의 루트 패스를 포함한 캐릭터 라인의 주소. 이 캐릭터 라인에는, Dsetup.dll 및 Dsetup32.dll 파일과 DirectX 재반포 가능 파일이 포함되어 있는 디렉토리에의 풀 패스를 지정할 필요가 있다. 이 값이 NULL 의 경우는, 현재의 작업 디렉토리가 사용된다.

dwFlags

DirectSetup 의 구성을 제어하는 컨트롤을 나타내는, 1 개 또는 복수의 플래그.

DSETUP_DIRECTX

DirectX 와 호환성이 있는 디스플레이 드라이버 및 오디오 드라이버에 가세해 DirectX 런타임 구성 요소를 인스톨 한다.

DSETUP_MANAGEDDX

Managed DirectX 구성 요소를 인스톨 한다. Managed DirectX 구성 요소를 인스톨 하려면 , Microsoft . NET Framework 가 인스톨 되고 있을 필요가 있다.

DSETUP_TESTINSTALL

인스톨 내용을 테스트한다. 새로운 구성 요소를 인스톨 할 것은 없다.

반환값

실패했을 경우는, 에러 코드를 돌려준다. 반환값의 일람에 대해서는, 「반환값」을 참조할것. 이 함수가 성공했을 경우, 이하의 성공 코드 가운데 1 개를 돌려준다.

DSETUPERR_SUCCESS	성공.
DSETUPERR_SUCCESS_RESTART	인스톨이 성공했지만, 변경 내용을 유효하게 하기 위해서 시스템을 재부팅 할 필요가 있다.

주의

셋업 프로그램으로 DirectXSetup 함수를 사용하기 전에, 시스템에 충분한 빈디스크 용량이 있는 것을 확인할 필요가 있다. DirectX 9.0 을 셋업 하기 위해서 필요한 최대 빈 용량은, Microsoft Windows® 98 , Windows Millennium Edition (Windows Me)에서는 20 MB, Windows 2000, Windows XP 에서는 25 MB 이다.

dwFlags 파라미터에는 다음의 플래그를 지정할 수 있다. 다만, DirectX 9.0 에서는 무시된다.

DSETUP_D3D	사용하지 않는다. 이 플래그를 사용하는 DirectX 프로그램은, DirectX 구성 요소를 모두 인스톨 한다.
DSETUP_DDRAW	사용하지 않는다. 이 플래그를 사용하는 DirectX 프로그램은, DirectX 구성 요소를 모두 인스톨 한다.
DSETUP_DDRAWDRV	DirectX 8.1 에서는 사용하지 않는다.
DSETUP_DINPUT	사용하지 않는다. 이 플래그를 사용하는 DirectX 프로그램은, DirectX 구성 요소를 모두 인스톨 한다.
DSETUP_DIRECTXSETUP	사용하지 않는다. 이 플래그를 사용하는 DirectX 프로그램은, DirectX 구성 요소를 모두 인스톨 한다.
DSETUP_DPLAY	사용하지 않는다. 이 플래그를 사용하는 DirectX 프로그램은, DirectX 구성 요소를 모두 인스톨 한다.
DSETUP_DPLAYSP	사용하지 않는다. 이 플래그를 사용하는 DirectX 프로그램은, DirectX 구성 요소를 모두 인스톨 한다.
DSETUP_DSOUND	사용하지 않는다. 이 플래그를 사용하는 DirectX 프로그램은, DirectX 구성 요소를 모두 인스톨 한다.
DSETUP_DSOUNDDRV	DirectX 8.1 에서는 사용하지 않는다.
DSETUP_DXCORE	DirectX 런타임 구성 요소를 인스톨 한다. DirectX 와 호환성이 있는 디스플레이 드라이버와 오디오 드라이버는 인스톨 하지 않는다.

함수의 정보

헤더	dsetup.h
임포트 라이브러리	dsetup.lib
최저한의 operating system	Windows 98