MPI_Ssend, fonction

Article
01/16/2024

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

Syntaxe

int MPIAPI MPI_Ssend(
  _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_SSEND(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’opération d’envoi dépend de l’occurrence d’une fonction de réception correspondante.

Cette fonction peut être appelée, qu’une réception correspondante soit publiée ou non. Toutefois, la fonction d’envoi s’exécute correctement uniquement si une réception correspondante est publiée et que l’opération de réception a commencé à recevoir le message. Par conséquent, l’achèvement d’un envoi synchrone indique non seulement que la mémoire tampon d’envoi peut être réutilisée, mais également que le processus de réception a commencé à exécuter la réception correspondante.

Si les opérations d’envoi et de réception sont des opérations bloquantes, le mode synchrone fournit une sémantique de communication synchrone ; une communication n’est pas terminée à l’une ou l’autre des extrémités tant que les processus d’envoi et de réception n’ont pas terminé.

Configuration requise

Produit	Package redistribuable MS-MPI HPC Pack 2012, package redistribuable HPC Pack 2008 R2 MS-MPI, package redistribuable MS-MPI HPC Pack 2008 ou utilitaires clients HPC Pack 2008
En-tête	Mpi.h ; Mpif.h
Bibliothèque	Msmpi.lib
DLL	Msmpi.dll