IDCompositionVirtualSurface::Trim 메서드(dcomp.h)

지정된 트리밍 사각형 외부에 있는 픽셀을 삭제합니다.

구문

HRESULT Trim(
  [in, optional] const RECT *rectangles,
  [in]           UINT       count
);

매개 변수

[in, optional] rectangles

형식: const RECT*

유지할 사각형 배열입니다.

[in] count

형식: UINT

사각형 배열의 사각형 수입니다 .

반환 값

형식: HRESULT

함수가 성공하면 S_OK를 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 DirectComposition 오류 코드를 참조하세요.

설명

가상 표면에는 표면의 모든 픽셀에 충분한 스토리지가 없을 수 있습니다. 애플리케이션은 IDCompositionSurface::BeginDraw 메서드를 호출하여 표면에 메모리를 할당하고 IDCompositionVirtualSurface::Trim 메서드를 호출하여 표면에 대한 메모리를 해제하도록 컴퍼지션 엔진에 지시합니다. 사각형 배열은 이 메서드가 반환된 후에도 할당된 상태를 유지해야 하는 가상 표면의 영역을 나타냅니다. 지정된 사각형 집합 외부에 있는 모든 픽셀은 더 이상 텍스처링에 사용되지 않으며 해당 메모리가 회수될 수 있습니다.

count 매개 변수가 0이면 픽셀이 유지되지 않고 가상 화면에 할당된 모든 메모리가 회수될 수 있습니다. 사각형 매개 변수는 count 매개 변수가 0인 경우에만 NULL일 수 있습니다.

IDCompositionSurface::EndDraw에 대한 해당 호출 없이 이 비트맵에 대해 IDCompositionSurface::BeginDraw가 호출된 경우 이 메서드는 실패합니다.

요구 사항

추가 정보

IDCompositionDevice::CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface::Resize