IDXGIDevice::CreateSurface 메서드(dxgi.h)

아티클
08/23/2023

표면을 반환합니다. 이 메서드는 내부적으로 사용되며 애플리케이션에서 직접 호출하면 안 됩니다.

구문

HRESULT CreateSurface(
  [in]           const DXGI_SURFACE_DESC    *pDesc,
                 UINT                       NumSurfaces,
                 DXGI_USAGE                 Usage,
  [in, optional] const DXGI_SHARED_RESOURCE *pSharedResource,
  [out]          IDXGISurface               **ppSurface
);

매개 변수

[in] pDesc

형식: const DXGI_SURFACE_DESC*

표면을 설명하는 DXGI_SURFACE_DESC 구조체에 대한 포인터입니다.

NumSurfaces

형식: UINT

만들 표면의 수입니다.

Usage

형식: DXGI_USAGE

표면 사용 방법을 지정하는 DXGI_USAGE 플래그입니다.

[in, optional] pSharedResource

형식: const DXGI_SHARED_RESOURCE*

이러한 리소스의 보기를 열기 위한 공유 리소스 정보를 포함하는 DXGI_SHARED_RESOURCE 구조체에 대한 선택적 포인터입니다.

[out] ppSurface

형식: IDXGISurface**

처음 만든 표면에 대한 IDXGISurface 인터페이스 포인터의 주소입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환합니다. 그렇지 않으면 오류 코드입니다. 오류 코드 목록은 DXGI_ERROR 참조하세요.

설명

CreateSurface 메서드는 하나 이상의 디바이스 간에 데이터를 교환하는 버퍼를 만듭니다. 내부적으로 사용되며 직접 호출해서는 안 됩니다.

런타임은 표면을 나타내는 Direct3D 리소스 개체를 만들 때 IDXGISurface 인터페이스를 자동으로 만듭니다. 예를 들어 런타임은 ID3D11Device::CreateTexture2D 또는 ID3D10Device::CreateTexture2D를 호출하여 2D 텍스처를 만들 때 IDXGISurface 인터페이스를 만듭니다. 2D 텍스처 표면을 나타내는 IDXGISurface 인터페이스를 검색하려면 ID3D11Texture2D::QueryInterface 또는 ID3D10Texture2D::QueryInterface를 호출합니다. 이 호출에서는 IDXGISurface의 식별자를 전달해야 합니다. 2D 텍스처에 단일 MIP 맵 수준만 있고 텍스처 배열로 구성되지 않으면 QueryInterface 가 성공하고 IDXGISurface 인터페이스 포인터에 대한 포인터를 반환합니다. 그렇지 않으면 QueryInterface 가 실패하고 IDXGISurface에 대한 포인터를 반환하지 않습니다.