17.2.381. MPI_T_event_set_dropped_handler

MPI_T_event_set_dropped_handler — Registers a function to be called when event information is dropped for the registration handle specified in event_registration

17.2.381.1. SYNTAX

17.2.381.1.1. C Syntax

#include <mpi.h>

int MPI_T_event_set_dropped_handler(MPI_T_event_registration event_registration,
                                    MPI_T_event_dropped_cb_function dropped_cb_function)

17.2.381.2. INPUT PARAMETERS

  • event_registration: Event registration

  • dropped_cb_function: pointer to user-defined callback function

17.2.381.3. DESCRIPTION

MPI_T_event_set_dropped_handler registers the function dropped_cb_function to be called by the MPI implementation when event information is dropped for the registration handle specified in event_registration.

17.2.381.4. ERRORS

MPI_T_event_set_dropped_handler will fail if:

  • MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface is not initialized.

  • MPI_T_ERR_INVALID_HANDLE: The handle is invalid.

  • MPI_T_ERR_INVALID_HANDLE: Invalid use of the interface or bad parameter values(s).

  • MPI_T_ERR_OTHER: Other error