ID2D1ImageSourceFromWic::EnsureCached(constD2D1_RECT_U*) 메서드(d2d1_3.h)

이미지 원본 캐시의 지정된 지역이 채워지도록 합니다. 이 메서드는 렌더링 루프 외부에서 캐시를 채우는 데 비용이 많이 드는 작업을 수행하여 결함을 최소화하는 데 사용할 수 있습니다. 이 메서드를 사용하여 루틴을 그리기 전에 이미지 데이터를 추측적으로 로드할 수도 있습니다.

구문

HRESULT EnsureCached(
  [in, optional] const D2D1_RECT_U *rectangleToFill
);

매개 변수

[in, optional] rectangleToFill

형식: const D2D1_RECT_U*

캐시에 채워야 하는 이미지 영역을 픽셀 단위로 지정합니다. 기본적으로 이미지의 전체 범위입니다.

반환 값

형식: HRESULT

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

설명

이 API는 해당 데이터가 아직 캐시되지 않은 경우 이미지 데이터를 이미지 원본의 캐시에 로드합니다. 기존 캐시(있는 경우)는 트리밍하지 않습니다.
캐시 내의 더 많은 영역을 실제로 요청된 것보다 채울 수 있습니다.

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

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

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	d2d1_3.h
라이브러리	D2d1_3.lib
DLL	D2d1_3.dll

추가 정보

ID2D1ImageSourceFromWic