Device.UpdateSurface Method

Language:

Copies rectangular subsets of pixels from one surface to another.

Overload List

public void UpdateSurface(Surface, Rectangle, Surface);
public void UpdateSurface(Surface, Rectangle, Surface, Point);
public void UpdateSurface(Surface, Surface);
public void UpdateSurface(Surface, Surface, Point);

Remarks

This method has the following restrictions.

The following table shows the supported format combinations.

Destination format
Source format Texture RT texture RT Off-screen plain
Texture Yes Yes Yes* Yes
RT texture No No No No
RT No No No No
Off-screen plain Yes Yes Yes Yes

* If the driver does not support the requested copy, it is emulated using locking and copying.

If the application needs to copy data from a Pool.Default render target to a Pool.SystemMemory surface, it can use Device.GetRenderTargetData.

Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.


Send comments about this topic to Microsoft. © Microsoft Corporation. All rights reserved.

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