Skip to content

Latest commit

 

History

History
68 lines (57 loc) · 2.99 KB

nn-dxgi-idxgisurface.md

File metadata and controls

68 lines (57 loc) · 2.99 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NN:dxgi.IDXGISurface
IDXGISurface (dxgi.h)
The IDXGISurface interface implements methods for image-data objects.
IDXGISurface
IDXGISurface interface [DXGI]
IDXGISurface interface [DXGI]
described
acd37adc-fb69-8924-76b4-598005b98bc9
direct3ddxgi.idxgisurface
dxgi/IDXGISurface
direct3ddxgi\idxgisurface.htm
direct3ddxgi
VS|directx_sdk|~\idxgisurface.htm
12/05/2018
IDXGISurface, IDXGISurface interface [DXGI], IDXGISurface interface [DXGI],described, acd37adc-fb69-8924-76b4-598005b98bc9, direct3ddxgi.idxgisurface, dxgi/IDXGISurface
dxgi.h
Windows
DXGI.lib
Windows
19H1
IDXGISurface
dxgi/IDXGISurface
c++
APIRef
kbSyntax
COM
DXGI.lib
DXGI.dll
IDXGISurface

-description

The IDXGISurface interface implements methods for image-data objects.

-inheritance

The IDXGISurface interface derives from IDXGIDeviceSubObject.

-remarks

An image-data object is a 2D section of memory, commonly called a surface. To get the surface from an output, call IDXGIOutput::GetDisplaySurfaceData.

Runtimes earlier than Direct3D 12 automatically create an IDXGISurface interface when they create a Direct3D resource object that represents a surface. IDXGISurface interfaces are not supported in Direct3D 12. For example, the runtime creates an IDXGISurface interface when you call ID3D11Device::CreateTexture2D or ID3D10Device::CreateTexture2D to create a 2D texture. To retrieve the IDXGISurface interface that represents the 2D texture surface, call ID3D11Texture2D::QueryInterface or ID3D10Texture2D::QueryInterface. In this call, you must pass the identifier of IDXGISurface. If the 2D texture has only a single MIP-map level and does not consist of an array of textures, QueryInterface succeeds and returns a pointer to the IDXGISurface interface pointer. Otherwise, QueryInterface fails and does not return the pointer to IDXGISurface.

-see-also

DXGI Interfaces

IDXGIDeviceSubObject