Edit

WriteableBitmap.BackBuffer Property

  • Reference

Definition

Namespace:
System.Windows.Media.Imaging
Assembly:
PresentationCore.dll

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