MPI_Irsend, fonction
Lance une opération d’envoi en mode prêt et retourne un handle de requête qui représente l’opération de communication.
Syntaxe
int MPIAPI MPI_Irsend(
_In_opt_ void *buf,
int count,
MPI_Datatype datatype,
int dest,
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. La mémoire tampon se compose du nombre d’éléments successifs de l’objet MPI_Datatype indiqué par le handle de type de données . La longueur du message est spécifiée en termes de nombre d’éléments, et non en nombre d’octets. L’appelant ne doit modifier aucune partie de la mémoire tampon d’envoi tant que l’opération de communication n’est pas terminée.count
Nombre d’éléments dans le tableau de mémoires tampons. Si count est égal à zéro, la partie données du message est vide.datatype
Handle qui représente le type de données des éléments dans la mémoire tampon.Dest
Rang du processus de destination dans le paramètre de communication communicator.tag
Balise de message utilisée pour distinguer différents types de messages.comm
Handle du communicateur.request [out]
Au retour, pointeur vers un handle qui représente l’opération de communication.
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_IRSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, REQUEST, IERROR)
<type> BUF(*)
INTEGER COUNT, DATATYPE, DEST, TAG, COMM, REQUEST, IERROR
Remarques
Cette fonction peut retourner avant la copie du message hors de la mémoire tampon d’envoi. Cette fonction est locale, elle retourne immédiatement, indépendamment de la status d’autres processus. Consultez les remarques relatives à la fonction MPI_Rsend pour obtenir la description du mode de communication prêt.
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 |