DirectX SDK

DirectDrawSurface7.GetLockedArray

The DirectDrawSurface7.GetLockedArray method returns a pointer to the array of locked pixels after a call to DirectDrawSurface7.Lock.

object.GetLockedArray( _ 
    array() As Byte)

Parameters

object
Object expression that resolves to a DirectDrawSurface7 object.
array()
Array of locked pixels, in bytes.

Error Codes

If the method fails, it raises an error, and Err.Number is set.

Remarks

This method is provided for advanced users. Use this method only between DirectDrawSurface7.Lock and DirectDrawSurface7.Unlock calls. On some display cards, the pitch is not equal to the width of the surface; be sure not to write in memory beyond the array.