17.2.369. MPI_T_event_copy

MPI_T_event_copy — Copy event data as a whole into a user-specified buffer.

17.2.369.1. SYNTAX

17.2.369.1.1. C Syntax

#include <mpi.h>

int MPI_T_event_copy(MPI_T_event_instance event_instance, void *buffer)

17.2.369.2. INPUT PARAMETERS

event_instance: event-instance handle provided to the callback function.
buf: pointer to a memory location to store the event data.

17.2.369.3. DESCRIPTION

MPI_T_event_copy copies the event data as a whole into the user-provided buffer. The user must assure that the buffer is of at least the size of the extent of the event type, which can be computed from the type and displacement information returned by the corresponding call to MPI_T_event_get_info.

17.2.369.4. ERRORS

MPI_T_event_copy 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