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

  • Artículo

Crea un objeto de superficie de subrecurso.

Sintaxis

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

Parámetros

index

Índice del objeto de superficie de subrecurso que se va a enumerar.

[out] ppSurface

Dirección de un puntero a una interfaz IDXGISurface2 que representa el objeto de superficie subrecurso creado en la posición especificada por el parámetro index .

Valor devuelto

Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve uno de los valores siguientes:

  • DXGI_ERROR_INVALID_CALL si el índice está fuera del intervalo o si el subrecurso no es una superficie válida.
  • E_OUTOFMEMORY si no hay suficiente memoria disponible para crear el objeto de superficie subrecurso.
Un subrecurso es una superficie válida si el recurso original hubiera sido una superficie válida si su tamaño de matriz fuera igual a 1.

Comentarios

Los objetos de superficie subresource implementan la interfaz IDXGISurface2 , que hereda de IDXGISurface1 e indirectamente IDXGISurface. Por lo tanto, los métodos GDI-interoperables de IDXGISurface1 funcionan si el objeto de interfaz de recursos original se creó con la marca GDI-interoperable (D3D11_RESOURCE_MISC_GDI_COMPATIBLE).

CreateSubresourceSurface crea una superficie de subrecurso basada en la interfaz de recursos en la que se llama a CreateSubresourceSurface . Por ejemplo, si el objeto de interfaz de recursos original es una textura 2D, la superficie de subrecurso creada también es una textura 2D.

Puedes usar CreateSubresourceSurface para crear partes de un recurso estéreo para que puedas usar Direct2D en la parte izquierda o derecha del recurso estéreo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dxgi1_2.h
Library Dxgi.lib

Consulte también

IDXGIResource1