Метод 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 создает буфер для обмена данными между одним или несколькими устройствами. Он используется для внутренних целей, и не следует вызывать его напрямую.

Среда выполнения автоматически создает интерфейс IDXGISurface при создании объекта ресурса Direct3D, представляющего поверхность. Например, среда выполнения создает интерфейс IDXGISurface при вызове ID3D11Device::CreateTexture2D или ID3D10Device::CreateTexture2D для создания двухмерной текстуры. Чтобы получить интерфейс IDXGISurface , представляющий поверхность двухмерной текстуры, вызовите ID3D11Texture2D::QueryInterface или ID3D10Texture2D::QueryInterface. В этом вызове необходимо передать идентификатор IDXGISurface. Если двухмерная текстура имеет только один уровень MIP-карты и не состоит из массива текстур, QueryInterface выполняется успешно и возвращает указатель на указатель интерфейса IDXGISurface . В противном случае QueryInterface завершается сбоем и не возвращает указатель на IDXGISurface.