IDirect3D9Ex::CreateDeviceEx 메서드(d3d9.h)

디스플레이 어댑터를 나타내는 디바이스를 만듭니다.

구문

HRESULT CreateDeviceEx(
  [in]          UINT                  Adapter,
  [in]          D3DDEVTYPE            DeviceType,
  [in]          HWND                  hFocusWindow,
  [in]          DWORD                 BehaviorFlags,
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [in, out]     D3DDISPLAYMODEEX      *pFullscreenDisplayMode,
  [out, retval] IDirect3DDevice9Ex    **ppReturnedDeviceInterface
);

매개 변수

[in] Adapter

형식: UINT

디스플레이 어댑터를 나타내는 서수입니다. D3DADAPTER_DEFAULT 항상 기본 디스플레이 어댑터입니다.

[in] DeviceType

형식: D3DDEVTYPE

디바이스 유형을 지정합니다. D3DDEVTYPE을 참조하세요. 원하는 디바이스 유형을 사용할 수 없는 경우 메서드가 실패합니다.

[in] hFocusWindow

형식: HWND

포커스 창은 애플리케이션이 포그라운드 모드에서 백그라운드 모드로 전환할 때 Direct3D에 경고합니다. 전체 화면 모드의 경우 지정된 창이 최상위 창이어야 합니다. 창 모드의 경우 이 매개 변수는 pPresentationParameters의 hDeviceWindow 멤버가 유효한 비 NULL 값으로 설정된 경우에만NULL 일 수 있습니다.

[in] BehaviorFlags

형식: DWORD

디바이스 만들기를 제어하는 하나 이상의 옵션( D3DCREATE 참조)의 조합입니다.

[in, out] pPresentationParameters

형식: D3DPRESENT_PARAMETERS*

만들 디바이스에 대한 프레젠테이션 매개 변수를 설명하는 D3DPRESENT_PARAMETERS 구조체에 대한 포인터입니다. BehaviorFlags가D3DCREATE_ADAPTERGROUP_DEVICE 지정하는 경우 이 매개 변수는 배열입니다. 존재하는 헤드 수에 관계없이 하나의 깊이/스텐실 표면만 자동으로 생성됩니다.

이 매개 변수는 입력 및 출력 매개 변수입니다. 이 메서드를 호출하면 다음을 비롯한 여러 멤버가 변경됩니다.

• BackBufferCount, BackBufferWidth 및 BackBufferHeight가 메서드가 호출되기 전에 0이면 메서드가 반환될 때 변경됩니다.
• BackBufferFormat이 메서드가 호출되기 전에 D3DFMT_UNKNOWN 같으면 메서드가 반환될 때 변경됩니다.

[in, out] pFullscreenDisplayMode

형식: D3DDISPLAYMODEEX*

디바이스가 전체 화면으로 설정된 경우의 디스플레이 모드입니다. D3DDISPLAYMODEEX를 참조하세요. BehaviorFlags가D3DCREATE_ADAPTERGROUP_DEVICE 지정하는 경우 이 매개 변수는 배열입니다. 창 모드의 경우 이 매개 변수는 NULL 이어야 합니다.

[out, retval] ppReturnedDeviceInterface

형식: IDirect3DDevice9Ex**

생성된 디바이스를 나타내는 반환된 IDirect3DDevice9Ex에 대한 포인터의 주소입니다.

반환 값

형식: HRESULT

이 메서드는 스왑 체인 버퍼와 함께 디바이스를 렌더링할 때 S_OK 반환합니다. 잘못된 호출자 입력 이외의 오류가 발생하면 D3DERR_DEVICELOST 반환됩니다.

요구 사항

대상 플랫폼	Windows
헤더	d3d9.h
라이브러리	D3D9.lib

추가 정보

IDirect3D9Ex