WriteableBitmap.BackBuffer Property

Reference

Definition

Namespace:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a pointer to the back buffer.

public:
 property IntPtr BackBuffer { IntPtr get(); };

[set: System.Security.SecurityCritical]
public IntPtr BackBuffer { [System.Security.SecurityCritical] get; }

public IntPtr BackBuffer { get; }

[<get: System.Security.SecurityCritical>]
[<set: System.Security.SecurityCritical>]
member this.BackBuffer : nativeint

member this.BackBuffer : nativeint

Public ReadOnly Property BackBuffer As IntPtr

Property Value

IntPtr

nativeint

An IntPtr that points to the base address of the back buffer.

Attributes: SecurityCriticalAttribute

Remarks

The back buffer contains the bitmap contents in the pixel format requested by the user.

Update the back buffer only between calls to the Lock and Unlock methods. If you do not follow the Lock/Unlock workflow described in the WriteableBitmap class remarks, undefined behaviors, such as tearing, can occur.

The address of the back buffer does not change.

Thread Safety

You can pass the BackBuffer pointer to external components and other threads for processing, but if you do, you must provide you own thread coordination. In particular, you must ensure that the UI thread specifies changed areas by calling the AddDirtyRect method, and that the UI thread unlocks the buffer by calling the Unlock method.

Applies to

Jaa