IDXARGBReadWritePtr interface
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 |