다음을 통해 공유

ID2D1DeviceContext::GetEffectInvalidRectangles 메서드(d2d1_1.h)

  • 아티클

마지막으로 효과를 그린 후 EndDraw 가 디바이스 컨텍스트에서 호출된 이후 누적된 잘못된 사각형을 가져옵니다.

구문

HRESULT GetEffectInvalidRectangles(
  [in]  ID2D1Effect *effect,
  [out] D2D1_RECT_F *rectangles,
  [in]  UINT32      rectanglesCount
);

매개 변수

[in] effect

형식: ID2D1Effect*

잘못된 사각형을 가져오는 효과입니다.

[out] rectangles

형식: D2D1_RECT_F*

D2D1_RECT_F 구조체의 배열입니다. 올바른 크기에 할당해야 합니다. GetEffectInvalidRectangleCount 메서드를 사용하여 잘못된 사각형 수를 가져올 수 있습니다.

[in] rectanglesCount

형식: UINT32

가져올 사각형의 수입니다.

반환 값

형식: HRESULT

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

HRESULT 설명
S_OK 오류가 발생하지 않았습니다.
E_OUTOFMEMORY Direct2D에서 호출을 완료하는 데 충분한 메모리를 할당할 수 없습니다.
E_INVALIDARG 잘못된 매개 변수가 반환 함수에 전달되었습니다.

설명

참고 Direct2D는 이러한 잘못된 사각형을 자동으로 사용하여 렌더링되는 효과의 영역을 줄이지 않습니다.
 

InvalidateEffectInputRectangle 메서드를 사용하여 Direct2D가 효과 그래프를 통해 전파할 무효화된 사각형을 지정할 수 있습니다.

여러 개의 잘못된 사각형이 요청되면 이 메서드가 반환하는 사각형이 겹칠 수 있습니다. 이 경우 사각형 수가 GetEffectInvalidRectangleCount의 개수보다 낮을 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 d2d1_1.h
DLL D2d1.dll

추가 정보

ID2D1DeviceContext