Motorola 6806800C47B manual 2 *ncsCkptCkptArrivalCallback, NcsCkptCkptArrivalCallback Parameters

API Description (*ncsCkptCkptArrivalCallback)()

The following table lists possible return values of this call.

Table 2-2 ncsCkptRegisterCkptArrivalCallback() Return Values

Return Value	Description
SA_AIS_OK	The function completed successfully
SA_AIS_ERR_LIBRARY	An unexpected problem
SA_AIS_ERR_BAD_HANDLE	the handle ckptHandle is invalid
SA_AIS_ERR_INVALID_PARAM	the callback function pointer is wrong
SA_AIS_ERR_NO_MEMORY	out of memory

2.1.2(*ncsCkptCkptArrivalCallback)()

Prototype

typedef void(*ncsCkptCkptArrivalCallbackT)(

Const SaCkptCheckpointHandleT checkpointHandle,

SaCkptIOVectorElementT *ioVector,

SaUnit32T numberOfElements

);

Parameters

The following table lists possible parameters.

Table 2-3 (*ncsCkptCkptArrivalCallback)() Parameters

Parameter	Description
checkpointHandle - [in]	Handle to the checkpoint that is available for reading.
ioVector - [in]	Pointer to a vector that contains elements
	ioVector[0],…,ioVector[numberOfElements - 1].
	Each element is of the type saCktptIOVectorElementT,
	defined in Section 3.3.4.1 of the document SAF-AIS-
	CKPT-B.01.01, which contains the following fields:
	z sectionId - [in] the identifier of the section
	available for reading.
	z dataBuffer - [in] Always set to NULL.
	z dataSize - [in] size of data available for reading.
	z dataOffset - [in] offset in the section that marks
	the start of the data that is available for reading.
	z readSize - [in] Always set to 0.
numberOfElements - [in]	the size of the ioVector.

Description

18 Checkpoint Service Programmer’s Reference (6806800C47B)