IG_fltr_metad_callback

This function returns the callback functions that ImageGear uses to pass or receive metadata during save and load operations.

Declaration:

	Copy Code
AT_ERRCODE ACCUAPI IG_fltr_metad_callback_get( LPVOID* lpPrivate, LPAFT_IG_METAD_ITEM_SET_CB* lplpfnSetCB, LPAFT_IG_METAD_ITEM_ADD_CB* lplpfnAddCB, LPAFT_IG_METAD_ITEM_GET_CB* lplpfnGetCB );

Arguments:

Name	Type	Description
lpPrivate	LPVOID*	Returns private data associated with metadata callback functions.
lplpfnSetCB	LPAFT_IG_METAD_ITEM_SET_CB*	Returns pointer to callback function of type LPAFT_IG_METAD_ITEM_SET_CB that is used for Set metadata operation.
lplpfnAddCB	LPAFT_IG_METAD_ITEM_ADD_CB*	Returns pointer to callback function of type LPAFT_IG_METAD_ITEM_ADD_CB that is used for Add metadata operation.
lplpfnGetCB	LPAFT_IG_METAD_ITEM_GET_CB*	Returns pointer to callback function of type LPAFT_IG_METAD_ITEM_GET_CB that is used for Get metadata operation.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

See GUI component source code.

Example:

	Copy Code
AT_ERRCOUNT nErrcount; // Count of returned errors on stack LPVOID lpPrivate; LPAFT_IG_METAD_ITEM_SET_CB lpfnSetCB; LPAFT_IG_METAD_ITEM_ADD_CB lpfnAddCB; LPAFT_IG_METAD_ITEM_GET_CB lpfnGetCB; // Get metadata callback functions nErrcount = IG_fltr_metad_callback_get(&lpPrivate, &lpfnSetCB, &lpfnAddCB, &lpfnGetCB);

Copy Code

AT_ERRCOUNT nErrcount;        // Count of returned errors on stack
LPVOID lpPrivate;
LPAFT_IG_METAD_ITEM_SET_CB lpfnSetCB;
LPAFT_IG_METAD_ITEM_ADD_CB lpfnAddCB;
LPAFT_IG_METAD_ITEM_GET_CB lpfnGetCB;

// Get metadata callback functions
nErrcount = IG_fltr_metad_callback_get(&lpPrivate, &lpfnSetCB, &lpfnAddCB, &lpfnGetCB);

Remarks:

A NULL value is valid for any parameter, if the corresponding information is not necessary to the application.

See also IG_fltr_metad_callback_set, LPAFT_IG_METAD_ITEM_ADD_CB, LPAFT_IG_METAD_ITEM_GET_CB, LPAFT_IG_METAD_ITEM_SET_CB functions and the section Processing of non-image data through filter callback functions.