A3DDllSetCallbacksReport

A3DStatus A3DDllSetCallbacksReport(A3DCallbackReportMessage, A3DCallbackReportWarning, A3DCallbackReportError)

Specifies custom functions the library uses for reporting messages, warnings and errors.

This function configures the library with the callback functions the library uses for reporting messages, warnings and errors.

To ensure your callback is aware of early-occurring messages, call the A3DDllSetCallbacksReport function immediately after the A3DDllInitialize function is successfully called.

2.0

Return Values

A3D_INITIALIZE_NOT_CALLED:

A3D_SUCCESS:

If you do not call this function, the library sends all messages to the null device. The first string returned by the two functions above corresponds to a unique error code. You can use that code to localize messages supplied to your users.

Sample code

A3DInt32 my_message(A3DUTF8Char *msg) { _tprintf(_T("%s"),msg); return fflush(stdout); }
A3DInt32 my_warning(A3DUTF8Char* pcCode, A3DUTF8Char *msg) { _tprintf(_T("WARNING #%s:"),pcCode); return my_message(msg); }
A3DInt32 my_error(A3DUTF8Char* pcCode, A3DUTF8Char *msg) { _tprintf(_T("ERROR #%s:"),pcCode); return my_message(msg); }

A3DInt32 iErr = A3D_SUCCESS;
A3DInt32 iMajorVersion,iMinorVersion = 0;

iErr = A3DDllGetVersion( &iMajorVersion, &iMinorVersion );
iErr = A3DDllInitialize( A3D_DLL_MAJORVERSION, A3D_DLL_MAJORVERSION );
if ( iErr == A3D_SUCCESS )
{
    iErr = A3DDllSetCallbacksReport( my_message , my_warning , my_error );
    iErr = A3DDllTerminate();
}

Returns

A3D_SUCCESS on success, or an error code on failure