17.2.383. MPI_T_event_register_callback

MPI_T_event_register_callback — Associates a user-defined function with an allocated event-registration handle

17.2.383.1. SYNTAX

17.2.383.1.1. C Syntax

int MPI_T_event_register_callback(MPI_T_event_registration
    event_registration, MPI_T_cb_safety cb_safety, MPI_Info info,
    void* user_data, MPI_T_event_cb_function event_cb_function)

17.2.383.2. INPUT PARAMETERS

  • event_registration: Event registration

  • cb_safety: maximum callback safety level

  • info: Info argument

  • user_data: pointer to a user-controlled buffer

  • event_cb_function: pointer to user-defined callback function

17.2.383.3. DESCRIPTION

MPI_T_event_register_callback associates a user-defined function pointed to by event_cb_function with an allocated event-registration handle. The maximum callback safety level supported by the callback function is passed in the argument cb_safety.

17.2.383.4. ERRORS

MPI_T_event_register_callback will fail if:

  • MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface not initialized

  • MPI_T_ERR_INVALID_HANDLE: The handle is invalid

  • MPI_T_ERR_INFO: Invalid info

  • MPI_T_ERR_OTHER: Other error