Surface Class

Language:

Queries and prepares surfaces.

Definition

Visual Basic NotInheritable Public Class Surface
Inherits Resource
Implements IDisposable

C# public sealed class Surface : Resource, IDisposable

C++ public ref class Surface sealed : Resource, IDisposable

JScript public final class Surface extends Resource implements IDisposable

Visual Basic	NotInheritable Public Class Surface Inherits Resource Implements IDisposable
C#	public sealed class Surface : Resource, IDisposable
C++	public ref class Surface sealed : Resource, IDisposable
JScript	public final class Surface extends Resource implements IDisposable

Members Table

The following table lists the members exposed by the object. Click a tab on the left to choose the type of member you want to view.

Events

Event Description

Disposing Occurs when the Dispose method is called or when the Surface object is finalized and collected by the garbage collector of the .NET common language runtime.

Methods

Method Description

Dispose Immediately releases the unmanaged resources used by the Surface object.

Equals Returns a value that indicates whether the current instance is equal to a specified object. Inherited from Resource.

Finalize Allows the Surface object to free resources before it is destroyed by the garbage collector.

FreePrivateData Frees the specified private data associated with the current resource. Inherited from Resource.

FromBitmap Creates a surface from a .NET bitmap object.

FromStream Creates a surface from a Microsoft .NET stream object.

GetContainer Provides access to the parent cube texture or texture (mipmap) object.

GetGraphics Retrieves a device context.

GetHashCode Returns the hash code for the current instance. Inherited from Resource.

GetObjectByValue This member supports the infrastructure for Microsoft DirectX 9.0 for Managed Code and is not intended to be used directly from your code.

GetPrivateData Copies the private data associated with a resource to a buffer. Inherited from Resource.

LockRectangle Locks a rectangle on a surface.

op_Equality Compares the current instance of a class to another instance to determine whether they are the same. Inherited from Resource.

op_Inequality Compares the current instance of a class to another instance to determine whether they are different. Inherited from Resource.

PreLoad Preloads a managed resource. Inherited from Resource.

raise_Disposing Raises the Microsoft.DirectX.Direct3D.Surface.Disposing event when called from within a derived class.

ReleaseGraphics Releases the device context obtained by calling Surface.GetGraphics.

SetPriority Assigns the resource-management priority for the current resource. Inherited from Resource.

SetPrivateData Associates data with the resource that is intended for use by the application. Data is passed by value, and multiple sets of data can be associated with a single resource. Inherited from Resource.

Surface Initializes a new instance of the Surface class.

UnlockRectangle Unlocks a rectangle on a surface.

UpdateUnmanagedPointer Updates the unmanaged pointer for this Surface object. This method supports the .NET Framework infrastructure and is not intended to be used directly in your code.

UpdateUnmanagedPointer Updates the unmanaged pointer for this Resource object. This method supports the Framework infrastructure and is not intended to be used directly in your code. Inherited from Resource.

Properties

Property Description

Description Retrieves the description of a surface.

Device Retrieves the device associated with a resource. Inherited from Resource.

Disposed Gets a value that indicates whether the object is disposed.

Priority Retrieves or sets the priority for the current resource. Inherited from Resource.

Type Retrieves the type of a resource. Inherited from Resource.

UnmanagedComPointer Returns the unmanaged Component Object Model (COM) IDirect3DResource9 interface pointer. Inherited from Resource.

UnmanagedComPointer Returns the unmanaged COM IDirect3DSurface9 interface pointer.

Event	Description
Disposing	Occurs when the Dispose method is called or when the Surface object is finalized and collected by the garbage collector of the .NET common language runtime.

Method	Description
Dispose	Immediately releases the unmanaged resources used by the Surface object.
Equals	Returns a value that indicates whether the current instance is equal to a specified object. Inherited from Resource.
Finalize	Allows the Surface object to free resources before it is destroyed by the garbage collector.
FreePrivateData	Frees the specified private data associated with the current resource. Inherited from Resource.
FromBitmap	Creates a surface from a .NET bitmap object.
FromStream	Creates a surface from a Microsoft .NET stream object.
GetContainer	Provides access to the parent cube texture or texture (mipmap) object.
GetGraphics	Retrieves a device context.
GetHashCode	Returns the hash code for the current instance. Inherited from Resource.
GetObjectByValue	This member supports the infrastructure for Microsoft DirectX 9.0 for Managed Code and is not intended to be used directly from your code.
GetPrivateData	Copies the private data associated with a resource to a buffer. Inherited from Resource.
LockRectangle	Locks a rectangle on a surface.
op_Equality	Compares the current instance of a class to another instance to determine whether they are the same. Inherited from Resource.
op_Inequality	Compares the current instance of a class to another instance to determine whether they are different. Inherited from Resource.
PreLoad	Preloads a managed resource. Inherited from Resource.
raise_Disposing	Raises the Microsoft.DirectX.Direct3D.Surface.Disposing event when called from within a derived class.
ReleaseGraphics	Releases the device context obtained by calling Surface.GetGraphics.
SetPriority	Assigns the resource-management priority for the current resource. Inherited from Resource.
SetPrivateData	Associates data with the resource that is intended for use by the application. Data is passed by value, and multiple sets of data can be associated with a single resource. Inherited from Resource.
Surface	Initializes a new instance of the Surface class.
UnlockRectangle	Unlocks a rectangle on a surface.
UpdateUnmanagedPointer	Updates the unmanaged pointer for this Surface object. This method supports the .NET Framework infrastructure and is not intended to be used directly in your code.
UpdateUnmanagedPointer	Updates the unmanaged pointer for this Resource object. This method supports the Framework infrastructure and is not intended to be used directly in your code. Inherited from Resource.

Property	Description
Description	Retrieves the description of a surface.
Device	Retrieves the device associated with a resource. Inherited from Resource.
Disposed	Gets a value that indicates whether the object is disposed.
Priority	Retrieves or sets the priority for the current resource. Inherited from Resource.
Type	Retrieves the type of a resource. Inherited from Resource.
UnmanagedComPointer	Returns the unmanaged Component Object Model (COM) IDirect3DResource9 interface pointer. Inherited from Resource.
UnmanagedComPointer	Returns the unmanaged COM IDirect3DSurface9 interface pointer.

Inheritance Hierarchy

Object
MarshalByRefObject
Resource
Surface

Class Information

Namespace Microsoft.DirectX.Direct3D

Assembly Microsoft.DirectX.Direct3D (microsoft.directx.direct3d.dll)

Strong Name Microsoft.DirectX.Direct3D, Version=1.0.900.0, Culture=neutral, PublicKeyToken=d3231b57b74a1492

Namespace	Microsoft.DirectX.Direct3D
Assembly	Microsoft.DirectX.Direct3D (microsoft.directx.direct3d.dll)
Strong Name	Microsoft.DirectX.Direct3D, Version=1.0.900.0, Culture=neutral, PublicKeyToken=d3231b57b74a1492

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center