17.2.382. MPI_T_event_read

MPI_T_event_read — Read the value of a event instance.

17.2.382.1. SYNTAX

17.2.382.1.1. C Syntax

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

17.2.382.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.382.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.382.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