MPI_Send fonction

Article
12/27/2023

Effectue une opération d’envoi en mode standard et retourne lorsque la mémoire tampon d’envoi peut être réutilisée en toute sécurité.

Syntaxe

int MPIAPI MPI_Send(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm
);

Paramètres

buf [in, facultatif]
Pointeur vers la mémoire tampon qui contient les données à envoyer.
count
Nombre d'éléments contenus dans la mémoire tampon. 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.
Dest
Rang du processus de destination dans le communicateur spécifié par le paramètre comm .
tag
Balise de message qui peut être utilisée pour distinguer différents types de messages.
comm
Handle du communicateur.

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

Remarques

Cette fonction n’est pas locale. La réussite de l’exécution peut dépendre de l’existence d’une fonction de réception correspondante.

Cette fonction peut retourner avant qu’une fonction de réception correspondante soit appelée si l’implémentation MPI met en mémoire tampon le message. Toutefois, l’espace de mémoire tampon peut être indisponible ou les messages sortants peuvent ne pas être mis en mémoire tampon pour des raisons de performances. Si le message n’est pas mis en mémoire tampon, la fonction ne retourne pas tant que les données n’ont pas été déplacées vers le processus de réception.

Cette fonction peut être appelée si une fonction de réception correspondante est publiée ou non. Elle peut se terminer avant la publication d’une fonction de réception correspondante.

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