función MPI_Irsend

Artículo
01/16/2024

Inicia una operación de envío en modo listo y devuelve un identificador de solicitud que representa la operación de comunicación.

Sintaxis

int MPIAPI MPI_Irsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm,
  _Out_    MPI_Request  *request
);

Parámetros

buf [in, optional]
Puntero al búfer que contiene los datos que se van a enviar. El búfer consta de recuento de elementos sucesivos del objeto MPI_Datatype indicado por el identificador de tipo de datos . La longitud del mensaje se especifica en términos de número de elementos, no en número de bytes. El autor de la llamada no debe modificar ninguna parte del búfer de envío hasta que se complete la operación de comunicación.
count
Número de elementos de la matriz de búfer. Si count es cero, la parte de datos del mensaje está vacía.
datatype
Identificador que representa el tipo de datos de los elementos del búfer.
dest
Rango del proceso de destino dentro del parámetro communicator comm .
tag
Etiqueta de mensaje que se usa para distinguir diferentes tipos de mensajes.
comm
Identificador del comunicador.
request [out]
Al devolver, un puntero a un identificador que representa la operación de comunicación.

Valor devuelto

Devuelve MPI_SUCCESS si se realiza correctamente. De lo contrario, el valor devuelto es un código de error.

En Fortran, el valor devuelto se almacena en el parámetro IERROR .

Fortran

    MPI_IRSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, REQUEST, IERROR

Comentarios

Esta función puede devolver antes de que se copie el mensaje fuera del búfer de envío. Esta función es local, devuelve inmediatamente, independientemente del estado de otros procesos. Consulte los comentarios de la función MPI_Rsend para obtener la descripción del modo de comunicación listo.

Requisitos

Producto	Paquete redistribuible de HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Client Utilities
Encabezado	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
Archivo DLL	Msmpi.dll