función MPI_Irecv

Artículo
05/24/2023

Inicia una operación de recepción y devuelve un identificador a la operación de comunicación solicitada.

Sintaxis

int MPIAPI MPI_Irecv(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          source,
           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.
count
Número de elementos de la matriz de búfer. Si la parte de datos del mensaje está vacía, establezca el parámetro count en 0.
datatype
Tipo de datos de los elementos del búfer.
source
Rango del proceso de envío dentro del comunicador especificado. Especifique la constante MPI_ANY_SOURCE para especificar que cualquier origen sea aceptable.
tag
Etiqueta de mensaje que se puede usar para distinguir diferentes tipos de mensajes. Especifique la constante MPI_ANY_TAG para indicar que cualquier etiqueta es aceptable.
comm
Identificador del comunicador.
request [out]
Al devolver, contiene un identificador para la operación de comunicación solicitada.

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_IRECV(BUF, COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR

Comentarios

Esta función es local, devuelve inmediatamente y no espera ningún otro proceso. Esta función puede devolver antes de que se reciba el mensaje en el búfer.

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