Partager via


MPI_Rsend, fonction

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

Syntaxe

int MPIAPI MPI_Rsend(
  _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_RSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

Remarques

Cette fonction n’est pas locale. Cette fonction retourne dès que la mémoire tampon d’envoi peut être réutilisée et ne dépend pas de la status d’une opération de réception correspondante. Toutefois, la réussite de l’opération d’envoi globale dépend de l’existence d’une opération de réception correspondante.

Cette fonction ne peut être appelée que si l’opération de réception correspondante est déjà publiée. Sinon, la fonction retourne une erreur et son résultat n’est pas défini. Sur certains systèmes, cette exigence élimine une partie de la négociation utilisée dans d’autres modes et peut améliorer les performances par rapport aux opérations d’envoi standard ou synchrone.

La fonction MPI_Rsend a la même sémantique que les fonctions MPI_Send et MPI_Ssend , mais elle avertit le système qu’une réception correspondante est déjà publiée. Ces informations peuvent vous éviter une surcharge. Par conséquent, dans un programme correct, un envoi prêt peut être remplacé par un envoi standard sans effet sur le comportement du programme autre que les performances.

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

Voir aussi

Fonctions point à point MPI

MPI_Send

MPI_Bsend

MPI_Ssend

MPI_Recv