ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U&) 메서드(d2d1_3.h)

이 메서드는 이미지 원본 캐시의 채워진 영역을 지정된 사각형으로만 트리밍합니다.

구문

HRESULT TrimCache(
  [ref] const D2D1_RECT_U & rectangleToPreserve
);

[ref] rectangleToPreserve

형식: const D2D1_RECT_U

이미지 원본 캐시에 보존해야 하는 이미지 영역을 픽셀 단위로 지정합니다. 사각형 외부에 있는 지역은 캐시에서 제거됩니다. 기본적으로 이 사각형은 빈 사각형이므로 전체 이미지가 캐시에서 제거됩니다.

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

이미지 원본을 그릴 배율을 포함하려면 제공된 지역을 생성해야 합니다. 이러한 좌표는 로컬 좌표로 제공되어야 합니다.
즉, 세계 변환 및 브러시 변환을 포함할 수 있는 DPI 및 기타 관련 변환에 따라 API를 호출하기 전에 조정해야 합니다.

이미지 원본을 만들 때 주문형 캐싱을 요청하지 않은 경우 이 메서드는 실패합니다.

ID2D1Device::ClearResources와 마찬가지로 호출자는 메모리 사용량을 줄이기 전에 이후에 D3D 플러시를 실행해야 할 수 있습니다.

이 작업은 D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND 옵션을 사용하여 이미지 원본을 초기화한 경우에만 지원됩니다.