다음을 통해 공유


Direct3DCreate9 함수(d3d9.h)

IDirect3D9 개체를 만들고 인터페이스를 반환합니다.

구문

IDirect3D9 * Direct3DCreate9(
  UINT SDKVersion
);

매개 변수

SDKVersion

형식: UINT

이 매개 변수의 값은 D3D_SDK_VERSION 합니다. 설명 부분을 참조하세요.

반환 값

형식: IDirect3D9*

성공하면 이 함수는 IDirect3D9 인터페이스에 대한 포인터를 반환합니다. 그렇지 않으면 NULL 포인터가 반환됩니다.

설명

Direct3D 개체는 그래픽 애플리케이션에서 만들어야 하는 첫 번째 Direct3D COM 개체와 애플리케이션이 릴리스해야 하는 마지막 개체입니다. 디바이스의 기능을 열거하고 검색하는 함수는 Direct3D 개체를 통해 액세스할 수 있습니다. 이를 통해 애플리케이션은 디바이스를 만들지 않고도 디바이스를 선택할 수 있습니다.

다음과 같이 IDirect3D9 개체를 만듭니다.


LPDIRECT3D9 g_pD3D = NULL;
    
if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))
    return E_FAIL;

IDirect3D9 인터페이스는 활성 디스플레이 어댑터의 열거를 지원하며 IDirect3DDevice9 개체를 만들 수 있습니다. 사용자가 데스크톱에 디바이스를 추가하거나 노트북을 핫 도킹하여 어댑터를 동적으로 추가하는 경우 해당 디바이스는 열거형에 포함되지 않습니다. 새 IDirect3D9 인터페이스를 만들면 새 디바이스가 노출됩니다.

D3D_SDK_VERSION 이 함수에 전달되어 애플리케이션이 컴파일되는 헤더 파일이 컴퓨터에 설치된 런타임 DLL의 버전과 일치하는지 확인합니다. D3D_SDK_VERSION 헤더 변경(또는 기타 코드 변경)에서 애플리케이션을 다시 빌드해야 하는 경우에만 런타임에서 변경됩니다. 이 함수가 실패하면 헤더 파일 버전이 런타임 DLL 버전과 일치하지 않음을 나타냅니다.

예제는 디바이스 만들기(Direct3D 9)를 참조하세요.

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 d3d9.h(D3D9.h 포함)
라이브러리 D3d9.lib
DLL D3d9.dll

추가 정보

Direct3D 함수