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

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

구문

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

[in] unnamedParam1

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

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

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

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

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

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

[in] unnamedParam2

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

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

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

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