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 |