LMarker::Insert
#include "ltwrappr.h"
virtual L_INT LMarker::Insert (uIndex, uMarker, uMarkerSize, pMarkerData)
L_UINT uIndex; |
/* position at which to insert the marker */ |
L_UINT uMarker; |
/* marker’s type */ |
L_UINT uMarkerSize; |
/* marker’s data size */ |
/* marker’s data */ |
Inserts a marker in a marker collection.
Parameter |
Description |
uIndex |
Position in the list at which to insert the marker. Pass uIndex > 0 to insert this marker after the first uIndex markers. Use 0xFFFFFFFF to append the marker to the end of the list. If there are fewer than uIndex markers in the collection, the marker will be appended to the end of the list. |
|
Use zero-based indexing. For example, if there are 10 markers in a list, the index of the last one is 9. If you insert a marker within a list, the indexes of other markers change to accommodate the insertion. |
uMarker |
Value that represents the type of marker to insert. Recommended values are between 0xE0 and 0xFE. Other values are possible, but before using other values, study the JPEG specs to determine which markers are allowed. |
uMarkerSize |
The size of the marker data, in bytes. This must be between 0 and 0xFFFD. |
pMarkerData |
Pointer to the marker data. This parameter is needed only if uMarkerSize > 0. The marker data should be at least uMarkerSize bytes. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
You can insert a marker anywhere in the marker collection.
Required DLLs and Libraries
LTFIL For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
Example
For an example, refer to LMarker::Create.