This function queries a mark for the data from one of its named blocks.

Declaration:

AT_ERRCOUNT ART_mark_block_query(
        HIGEAR hIGear, 
        ART_MARK_INDEX hMarkIndex, 
        const LPART_BLOCK_NAME lpBlockName, 
        LPVOID lpBlockData, 
        LPDWORD lpBlockSize
);

Arguments:

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Sample:

Annotation

Example:

HIGEAR  hIGear; /* HIGEAR handle of image */
ART_MARK_INDEX hMarkIndex; /* index to mark   */
/* associated   */ 
/* with block being  */
/* queried    */
LPVOID   BlockData; /* memory to hold data  */
/* from block  */
DWORD  BlockSize; /* size of blocks,   */
/* in byte    */
nErrcount = ART_mark_block_query(hIGear, hMarkIndex, 
ART_BLOCK_ANODAT, NULL, &BlockSize);
BlockData = (LPVOID)alloca(BlockSize);
nErrcount = ART_mark_block_query(hIGear, hMarkIndex,
ART_BLOCK_ANODAT, &BlockData, &BlockSize);

Remarks:

The block data for the named block associated with lpBlockName is copied into lpBlockData. The buffer pointed to by lpBlockData is large enough to fit the named block data. The size of the block is returned to lpBlockSize.

To find the size needed for a buffer to hold the block data, set lpBlockData to NULL and the size of the block is returned in lpBlockSize.

An error is set if any of the following conditions are met:

• hIGear does not reference a valid ImageGear handle.
• There are no marks with a matching index block.
• lpBlockName does not point to a valid address.
• lpBlockData does not point to a valid address or is not NULL.
• lpBlockData points to a buffer smaller than the block data.
• lpBlockSize points to an invalid address.
• lpBlockSize points to a value smaller than the size of the block data.