DirectShow DirectShow 레퍼런스 인터페이스 IOverlay SetColorKey   [목차열람] [주소복사] [슬롯비우기]

IOverlay::SetColorKey

SetColorKey 메서드는, 컬러 키를 변경한다.

구문

HRESULT SetColorKey(
  COLORKEY *pColorKey
);

파라미터

pColorKey

[in, out] 설정하는 컬러 키값의 포인터. 성공했을 경우는, 실제로 선택된 컬러 키값이, 이 인수에 복사 된다.

반환값

성공했을 경우는 S_OK 를 돌려준다. pColorKey 가 NULL 의 경우는 E_POINTER 를 돌려준다. pColorKey 의 값이 현재의 팔레트 또는 픽셀 포맷으로 무효의 경우는 E_INVALIDARG 를 돌려준다.

주의

SetColorKey 메서드를 사용해 컬러 키를 변경 하면, 모든 아드바이즈린크가, 새로운 색이 지정된 IOverlayNotify::OnColorKeyChange 콜백 메서드를 받는다.

팔레트화 되고 있는 디스플레이상의 IOverlay::Advise 을 사용할 때, 필터는, 컬러 키를 짜넣는 (SetColorKey 를 사용) 일도, 팔레트를 짜넣는 (IOverlay::SetPalette 를 사용) 일도 할 수 있지만, 양쪽 모두를 짜넣을 수 없다. 이것은, 이 모드의 컬러 키에서는 팔레트가 인식될 필요가 있어, 이것이 SetPalette 와 모순되기 때문이다. 컬러 키를 삭제하려면 , CK_NOCOLORKEY 플래그를 지정해 컬러 키를 요구한다. 같이SetPalette 로 짜넣은 팔레트를 삭제하려면 ,SetPalette 를 호출해 NULL 인수를 건네준다 (즉 SetPalette(0, NULL)).

컬러 키가 짜넣어지고 있을 때, 팔레트를 설정하려고 하면 VFW_E_PALETTE_SET 에러가 반환된다. 팔레트가 짜넣어지고 있을 때, 컬러 키를 설정하려고 하면 VFW_E_COLOR_KEY_SET 가 반환된다.

참조

• 에러 코드와 성공 코드
• IOverlay 인터페이스