IDXGIResource1::CreateSubresourceSurface method (dxgi1_2.h)

Creates a subresource surface object.

Syntax

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

Parameters

index

The index of the subresource surface object to enumerate.

[out] ppSurface

The address of a pointer to a IDXGISurface2 interface that represents the created subresource surface object at the position specified by the index parameter.

Return value

Returns S_OK if successful; otherwise, returns one of the following values:

• DXGI_ERROR_INVALID_CALL if the index is out of range or if the subresource is not a valid surface.
• E_OUTOFMEMORY if insufficient memory is available to create the subresource surface object.

Remarks

Subresource surface objects implement the IDXGISurface2 interface, which inherits from IDXGISurface1 and indirectly IDXGISurface. Therefore, the GDI-interoperable methods of IDXGISurface1 work if the original resource interface object was created with the GDI-interoperable flag (D3D11_RESOURCE_MISC_GDI_COMPATIBLE).

CreateSubresourceSurface creates a subresource surface that is based on the resource interface on which CreateSubresourceSurface is called. For example, if the original resource interface object is a 2D texture, the created subresource surface is also a 2D texture.

You can use CreateSubresourceSurface to create parts of a stereo resource so you can use Direct2D on either the left or right part of the stereo resource.

Requirements

See also

IDXGIResource1