다음을 통해 공유

IDirectDrawSurface7::SetColorKey 메서드(ddraw.h)

  • 아티클

하드웨어가 표면별로 색 키를 지원하는 경우 DirectDrawSurface 개체의 색 키 값을 설정합니다.

구문

HRESULT SetColorKey(
  [in] DWORD        unnamedParam1,
  [in] LPDDCOLORKEY unnamedParam2
);

매개 변수

[in] unnamedParam1

요청된 색 키를 지정하기 위해 다음 플래그 중 하나로 설정할 수 있는 값입니다.

DDCKEY_COLORSPACE

구조체에 색 공간이 포함됩니다. 구조체에 단일 색 키가 포함되어 있으면 설정되지 않습니다.

DDCKEY_DESTBLT

비트 블록 전송(bitblt) 작업의 대상 색 키로 사용할 색 키 또는 색 공간입니다.

DDCKEY_DESTOVERLAY

오버레이 작업의 대상 색 키로 사용할 색 키 또는 색 공간입니다.

DDCKEY_SRCBLT

비트blt 작업의 원본 색 키로 사용할 색 키 또는 색 공간입니다.

DDCKEY_SRCOVERLAY

오버레이 작업의 원본 색 키로 사용할 색 키 또는 색 공간입니다.

[in] unnamedParam2

DirectDrawSurface 개체의 새 색 키 값을 포함하는 DDCOLORKEY 구조체에 대한 포인터입니다. 이 값은 NULL로 이전에 설정된 색 키를 제거할 수 있습니다.

반환 값

메서드가 성공하면 반환 값이 DD_OK.

실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.

  • DDERR_GENERIC
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_INVALIDSURFACETYPE
  • DDERR_NOOVERLAYHW
  • DDERR_NOTAOVERLAYSURFACE
  • DDERR_SURFACELOST
  • DDERR_UNSUPPORTED
  • DDERR_WASSTILLDRAWING

설명

투명한 비트블렛 작업 및 오버레이의 경우 대상 표면의 대상 색과 원본 표면의 원본 색을 설정합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 ddraw.h
라이브러리 Ddraw.lib
DLL Ddraw.dll

추가 정보

IDirectDrawSurface7