DirectXSetupCallbackFunction 함수

옵션으로 셋업 프로그램으로 설정하는 콜백 함수의 플레이스홀더명이다. 설정된 콜백 함수는, 셋업 프로세스의 각 스텝 마다 한 번 두개 호출된다.

구문

DWORD DirectXSetupCallbackFunction(      

    DWORD Reason,
    DWORD MsgType,
    char *szMessage,
    char *szName,
    void *pInfo
);

파라미터

Reason

콜백의 이유. 다음의 몇개의 값을 취한다.

DSETUP_CB_MSG_BEGIN_INSTALL

DirectXSetup 가 Microsoft® DirectX 구성 요소의 인스톨을 시작 하려고 하고 있다. DirectX 의 버전, operating system, 시스템 언어, 필요한 디스크 용량에 관해서, 시스템이 체크된다.

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
임포트 라이브러리	없음
최저한의 operating system	Windows 98

참조

「DirectXSetupSetCallback 」, 「셋업의 커스터마이즈」