IDirectDrawSurface7::SetClipper 메서드(ddraw.h)
clipper 개체를 이 표면에 연결하거나 삭제합니다.
구문
HRESULT SetClipper(
[in] LPDIRECTDRAWCLIPPER unnamedParam1
);
매개 변수
[in] unnamedParam1
DirectDrawSurface 개체에 연결할 DirectDrawClipper 개체의 IDirectDrawClipper 인터페이스에 대한 포인터입니다. 이 매개 변수를 NULL로 설정하면 현재 DirectDrawClipper 개체가 분리됩니다.
반환 값
메서드가 성공하면 반환 값이 DD_OK.
실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDSURFACETYPE
- DDERR_NOCLIPPERATTACHED
설명
클리퍼를 처음으로 표면으로 설정하면 SetClipper 는 클리퍼의 참조 횟수를 증가합니다. 후속 호출은 클리퍼의 참조 수에 영향을 미치지 않습니다. NULL을 lpDDClipper 매개 변수로 전달하면 클리퍼가 표면에서 제거되고 클리퍼의 참조 수가 감소합니다. 클리퍼를 삭제하지 않으면 표면 자체가 해제될 때 표면이 클리퍼에 대한 참조를 자동으로 해제합니다. COM 규칙에 따라 애플리케이션은 개체가 더 이상 필요하지 않을 때 클리퍼에 보유하는 모든 참조를 해제해야 합니다.
SetClipper 는 주로 기본 표면에 오버레이되거나 비트블릿되는 표면에서 사용됩니다. 그러나 모든 표면에서 사용할 수 있습니다. DirectDrawClipper 개체가 연결되고 클립 목록이 연결된 후에는 DirectDrawClipper 개체가 IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch 및 부모 DirectDrawSurface 개체를 포함하는 IDirectDrawSurface7::UpdateOverlay 작업에 사용됩니다. SetClipper 는 DirectDrawSurface 개체의 현재 DirectDrawClipper 개체를 분리할 수도 있습니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | ddraw.h |
| 라이브러리 | Ddraw.lib |
| DLL | Ddraw.dll |