Método IDXGIResource1::CreateSubresourceSurface (dxgi1_2.h)

  • Artigo

Cria um objeto de superfície de sub-recurso.

Sintaxe

HRESULT CreateSubresourceSurface(
        UINT          index,
  [out] IDXGISurface2 **ppSurface
);

Parâmetros

index

O índice do objeto de superfície de sub-recurso a ser enumerado.

[out] ppSurface

O endereço de um ponteiro para uma interface IDXGISurface2 que representa o objeto de superfície de sub-recurso criado na posição especificada pelo parâmetro index .

Retornar valor

Retorna S_OK se tiver êxito; caso contrário, retorna um dos seguintes valores:

  • DXGI_ERROR_INVALID_CALL se o índice estiver fora do intervalo ou se o sub-recurso não for uma superfície válida.
  • E_OUTOFMEMORY se a memória insuficiente estiver disponível para criar o objeto de superfície de sub-recurso.
Um sub-recurso é uma superfície válida se o recurso original teria sido uma superfície válida se seu tamanho de matriz fosse igual a 1.

Comentários

Objetos de superfície de sub-recurso implementam a interface IDXGISurface2 , que herda de IDXGISurface1 e indiretamente IDXGISurface. Portanto, os métodos interoperáveis GDI de IDXGISurface1 funcionarão se o objeto de interface de recurso original tiver sido criado com o sinalizador interoperável GDI (D3D11_RESOURCE_MISC_GDI_COMPATIBLE).

CreateSubresourceSurface cria uma superfície de sub-recurso baseada na interface de recurso na qual CreateSubresourceSurface é chamado. Por exemplo, se o objeto de interface de recurso original for uma textura 2D, a superfície de sub-recurso criada também será uma textura 2D.

Você pode usar CreateSubresourceSurface para criar partes de um recurso estéreo para poder usar Direct2D na parte esquerda ou direita do recurso estéreo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dxgi1_2.h
Biblioteca Dxgi.lib

Confira também

IDXGIResource1