IDXARGBReadWritePtr interface

  • Article

The IDXARGBReadWritePtr interface enables Microsoft DirectX Transform objects to gain read/write access to samples contained in a DXSurface object.

Members

The IDXARGBReadWritePtr interface inherits from IDXARGBReadPtr. IDXARGBReadWritePtr also has these types of members:

  • Methods

Methods

The IDXARGBReadWritePtr interface has these methods.

Method Description
CopyAndMoveBoth

Copies the specified number of samples from the current position of the source surface to the current position of the output surface.
CopyRect

Copies the specified number of samples from the specified rectangle in the source surface to the current position on the output surface.
FillAndMove

Fills the output surface with the specified sample value, starting at the current position and advancing the current position.
FillRect

Fills a rectangle with the sample value, optionally doing an alpha-blend with the destination.
OverArrayAndMove

Alpha-blends an array of samples over the output surface and moves the pointer a specified number of samples.
OverSample

Alpha-blends the sample value over the sample at the specified position.
PackAndMove

Places a buffer of ARGB32 samples into the output surface and moves the sample pointer.
PackPremultAndMove

Places a buffer of ARGB32 samples into the output surfaces and moves the sample pointer.
PackRect

Accepts a buffer of either PMARGB32 or ARGB32 samples and writes them to a subsection of the output surface defined by a DXPACKEDRECTDESC structure.

 

Remarks

This interface contains methods that select various locations within a DXSurface and IDXARGBReadWritePtr::PackAndMoveARGB32 or PMARGB32 transformed samples into the native, underlying format of the output surface. A pointer to this interface is returned when you use the IDXSurface::LockSurface method with the DXLOCKF_READWRITE flag set.

This interface inherits from IDXARGBReadPtr interface.

For more information on using this interface, see About Transforms and DXSurfaces.

If you create a custom DXSurface, you must implement this interface on your object, which is used to access samples within your custom surface.

Note  To enhance performance on these methods, no parameter validation is done before execution. Passing invalid parameters to any of these methods might cause the .dll to crash.

 

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

 Dxtrans.h

IDL

 Dxtrans.idl

DLL

 Dxtrans.dll