17.2.380. MPI_T_event_register_callback

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

17.2.380.1. SYNTAX

17.2.380.1.1. C Syntax

#include <mpi.h>

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_funciton event_cb_function)

17.2.380.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.380.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.380.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