IDCompositionDevice2::CreateVirtualSurface 메서드(dcomp.h)

컴퍼지션을 위해 하나 이상의 시각적 개체와 연결할 수 있는 채우기가 거의 없는 표면을 만듭니다.

구문

HRESULT CreateVirtualSurface(
  [in]  UINT                        initialWidth,
  [in]  UINT                        initialHeight,
  [in]  DXGI_FORMAT                 pixelFormat,
  [in]  DXGI_ALPHA_MODE             alphaMode,
  [out] IDCompositionVirtualSurface **virtualSurface
);

매개 변수

[in] initialWidth

형식: UINT

표면의 너비(픽셀)입니다. 최대 너비는 16,777,216픽셀입니다.

[in] initialHeight

형식: UINT

표면의 높이(픽셀)입니다. 최대 높이는 16,777,216픽셀입니다.

[in] pixelFormat

형식: DXGI_FORMAT

표면의 픽셀 형식입니다.

[in] alphaMode

형식: DXGI_ALPHA_MODE

픽셀 형식에 알파 채널이 포함된 경우 알파 채널의 의미입니다. 다음 값 중 하나일 수 있습니다.

[out] virtualSurface

형식: IDCompositionVirtualSurface**

새로 만든 Surface 개체입니다. 이 매개 변수는 NULL이 아니어야 합니다.

반환 값

형식: HRESULT

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

설명

Microsoft DirectComposition 스파스 표면은 컴퍼지션을 위해 시각적 개체와 연결할 수 있는 픽셀의 사각형 배열처럼 동작하는 논리적 개체입니다. 표면이 모든 픽셀에 대해 물리적 비디오 또는 시스템 메모리로 반드시 뒷받침되는 것은 아닙니다. 애플리케이션은 논리 표면의 일부를 서로 다른 시간에 실현하거나 가상화할 수 있습니다.

새로 만든 Surface 개체가 초기화되지 않은 상태입니다. 초기화되지는 않았지만 표면은 시각적 트리의 컴퍼지션에 영향을 주지 않습니다. 100% 투명 픽셀로 초기화된 표면과 똑같이 동작합니다.

픽셀 데이터를 사용하여 표면을 초기화하려면 IDCompositionSurface::BeginDraw 및 IDCompositionSurface::EndDraw 메서드를 사용합니다. 이 메서드는 표면에 픽셀을 제공 할뿐만 아니라 해당 픽셀에 대한 실제 저장 공간을 할당합니다. 메모리 할당은 애플리케이션이 일부 메모리를 시스템에 반환할 때까지 유지됩니다. 애플리케이션은 IDCompositionVirtualSurface::Trim 메서드를 호출하여 할당된 메모리의 일부 또는 전부를 해제할 수 있습니다.

DirectComposition 표면은 다음 픽셀 형식을 지원합니다.

• DXGI_FORMAT_B8G8R8A8_UNORM
• DXGI_FORMAT_R8G8B8A8_UNORM
• DXGI_FORMAT_R16G16B16A16_FLOAT

요구 사항

추가 정보

IDCompositionDevice2

IDCompositionDevice::CreateSurface