Partager via


MPI_Irecv fonction

Lance une opération de réception et retourne un handle à l’opération de communication demandée.

Syntaxe

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

Paramètres

  • buf [in, facultatif]
    Pointeur vers la mémoire tampon qui contient les données à envoyer.

  • count
    Nombre d’éléments dans le tableau de mémoires tampons. Si la partie données du message est vide, définissez le paramètre count sur 0.

  • datatype
    Type de données des éléments dans la mémoire tampon.

  • source
    Rang du processus d’envoi dans le communicateur spécifié. Spécifiez la constante MPI_ANY_SOURCE pour spécifier qu’une source est acceptable.

  • tag
    Balise de message qui peut être utilisée pour distinguer différents types de messages. Spécifiez la constante MPI_ANY_TAG pour indiquer qu’une balise est acceptable.

  • comm
    Handle du communicateur.

  • request [out]
    Au retour, contient un handle pour l’opération de communication demandée.

Valeur retournée

Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.

Dans Fortran, la valeur de retour est stockée dans le paramètre IERROR .

Fortran

    MPI_IRECV(BUF, COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR

Remarques

Cette fonction est locale, elle retourne immédiatement et n’attend aucun autre processus. Cette fonction peut retourner avant que le message ne soit reçu dans la mémoire tampon.

Configuration requise

Produit

HpC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities

En-tête

Mpi.h ; Mpif.h

Bibliothèque

Msmpi.lib

DLL

Msmpi.dll

Voir aussi

Fonctions point à point MPI

MPI_Send

MPI_Recv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype