17.2.379. MPI_T_event_read

MPI_T_event_read — Read the value of a event instance.

17.2.379.1. SYNTAX

17.2.379.1.1. C Syntax

#include <mpi.h>

int MPI_T_event_read(MPI_T_event_instance event_instance, int elem_index, void *buffer)

17.2.379.2. INPUT PARAMETERS

  • event_instance: event-instance handle provided to the callback function.

  • elem_index: index into the array of datatypes of the item to be queried.

  • buffer: pointer to a memory location to store the item data

17.2.379.3. DESCRIPTION

MPI_T_event_read allows users to copy one element of the event data to a userspecified buffer at a time.

17.2.379.4. ERRORS

MPI_T_event_read 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

See also