IDirect3D9::CheckDeviceFormatConversion 메서드(d3d9.h)

디바이스를 테스트하여 한 디스플레이 형식에서 다른 디스플레이 형식으로의 변환을 지원하는지 확인합니다.

구문

HRESULT CheckDeviceFormatConversion(
  [in] UINT       Adapter,
  [in] D3DDEVTYPE DeviceType,
  [in] D3DFORMAT  SourceFormat,
  [in] D3DFORMAT  TargetFormat
);

매개 변수

[in] Adapter

형식: UINT

디스플레이 어댑터 서수입니다. D3DADAPTER_DEFAULT 항상 기본 디스플레이 어댑터입니다. 이 메서드는 이 값이 시스템의 디스플레이 어댑터 수와 같거나 초과할 때 D3DERR_INVALIDCALL 반환합니다.

[in] DeviceType

형식: D3DDEVTYPE

디바이스 유형. D3DDEVTYPE 열거형 형식의 멤버입니다.

[in] SourceFormat

형식: D3DFORMAT

원본 어댑터 형식입니다. D3DFORMAT 열거형 형식의 멤버입니다.

[in] TargetFormat

형식: D3DFORMAT

대상 어댑터 형식입니다. D3DFORMAT 열거형 형식의 멤버입니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값이 D3DERR_INVALIDCALL. 하드웨어가 두 형식 간의 변환을 지원하지 않는 경우 메서드는 D3DERR_NOTAVAILABLE 반환합니다.

설명

CheckDeviceType을 사용하여 표시 형식과 다른 백 버퍼 간의 호환성을 테스트하면 적절한 값이 반환됩니다. 즉, 호출은 디바이스 기능을 반영합니다. 디바이스가 요청된 백 버퍼 형식으로 렌더링할 수 없는 경우 호출은 여전히 D3DERR_NOTAVAILABLE 반환합니다. 디바이스가 형식으로 렌더링할 수 있지만 색 변환 프레젠테이션을 수행할 수 없는 경우 반환 값도 D3DERR_NOTAVAILABLE. 애플리케이션은 CheckDeviceFormatConversion을 호출하여 프레젠테이션 자체에 대한 하드웨어 지원을 검색할 수 있습니다. 색 변환 프레젠테이션 자체에 대한 소프트웨어 에뮬레이션은 제공되지 않습니다.

CheckDeviceFormatConversion 을 사용하여 StretchRect 호출에서 허용되는 원본 표면 형식과 대상 표면 형식의 조합을 확인할 수도 있습니다.

색 변환은 다음 원본 및 대상 형식으로 제한됩니다.

  • 원본 형식은 FOURCC 형식 또는 유효한 백 버퍼 형식이어야 합니다. 이러한 목록은 FourCC 형식 및 BackBuffer 또는 표시 형식을 참조하세요.
  • 대상 형식은 다음 서명되지 않은 형식 중 하나여야 합니다.
    D3DFMT_X1R5G5B5 D3DFMT_A1R5G5B5 D3DFMT_R5G6B5
    D3DFMT_R8G8B8 D3DFMT_X8R8G8B8 D3DFMT_A8R8G8B8
    D3DFMT_A2R10G10B10 D3DFMT_A16B16G16R16 D3DFMT_A2B10G10R10
    D3DFMT_A8B8G8R8 D3DFMT_X8B8G8R8 D3DFMT_A16B16G16R16F
    D3DFMT_A32B32G32R32F
     

요구 사항

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

추가 정보

ColorFill

IDirect3D9