IDirect3DDevice9::SetDialogBoxMode 메서드(d3d9helper.h)

이 메서드를 사용하면 전체 화면 모드 애플리케이션에서 GDI 대화 상자를 사용할 수 있습니다.

구문

HRESULT SetDialogBoxMode(
  [in] BOOL bEnableDialogs
);

매개 변수

[in] bEnableDialogs

형식: BOOL

TRUE 이면 GDI 대화 상자를 사용하도록 설정하고 FALSE 를 사용하여 사용하지 않도록 설정합니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 다음이 모두 true가 아닌 한 반환 값을 D3DERR_INVALIDCALL 수 있습니다.

  • 애플리케이션은 GDI와 호환되는 백 버퍼 형식을 지정했습니다. 즉, D3DFMT_X1R5G5B5, D3DFMT_R5G6B5 또는 D3DFMT_X8R8G8B8 중 하나입니다.
  • 애플리케이션은 다중 샘플링을 지정하지 않았습니다.
  • 지정된 애플리케이션 D3DSWAPEFFECT_DISCARD.
  • 지정된 애플리케이션 D3DPRESENTFLAG_LOCKABLE_BACKBUFFER.
  • 애플리케이션에서 D3DCREATE_ADAPTERGROUP_DEVICE 지정하지 않았습니다.
  • 애플리케이션이 BeginScene과 EndScene 사이에 있지 않습니다.

설명

GDI 대화 상자는 디바이스 창에 자식으로 만들어야 합니다. 또한 부모 창에서 자식 창 다시 그리기를 관리할 수 있으므로 디바이스를 만든 동일한 스레드 내에서 만들어야 합니다.

메서드는 창 모드 애플리케이션에 영향을 주지 않지만 애플리케이션이 디바이스를 전체 화면 모드로 다시 설정하는 경우 이 설정이 적용됩니다. SetDialogBoxMode가 창 모드 애플리케이션에서 성공하면 다음에 전체 화면 모드로 다시 설정이 위에 나열된 제한 사항에 대해 확인됩니다. 또한 SetDialogBoxMode는 스왑 체인의 모든 백 버퍼를 삭제하므로 애플리케이션은 이 호출 후 모든 백 버퍼에 대한 콘텐츠를 새로 고쳐야 합니다.

요구 사항

   
대상 플랫폼 Windows
헤더 d3d9helper.h(D3D9.h 포함)
라이브러리 D3D9.lib

추가 정보

IDirect3DDevice9