Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IDXGISurface interface

The IDXGISurface interface implements methods for image-data objects.

Members

The IDXGISurface interface inherits from IDXGIDeviceSubObject. IDXGISurface also has these types of members:

Methods

The IDXGISurface interface has these methods.

MethodDescription
GetDesc

Get a description of the surface.

Map

Get a pointer to the data contained in the surface, and deny GPU access to the surface.

Unmap

Invalidate the pointer to the surface retrieved by IDXGISurface::Map and re-enable GPU access to the resource.

 

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.

The runtime automatically creates an IDXGISurface interface when it creates a Direct3D resource object that represents a surface. 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.

Requirements

Header

DXGI.h

Library

DXGI.lib

See also

IDXGIDeviceSubObject
DXGI Interfaces

 

 

Show:
© 2016 Microsoft