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 |