MPI_Bsend fonction

Article
12/27/2023

Envoie des données à un processus spécifié en mode mis en mémoire tampon. Cette fonction retourne lorsque la mémoire tampon d’envoi peut être réutilisée en toute sécurité.

Syntaxe

int MPIAPI MPI_Bsend(
  _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 dans le tableau de mémoires tampons. 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_BSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

Remarques

Cette fonction est locale, elle peut effectuer l’opération d’envoi correctement sans qu’une opération de réception correspondante se produise.

Cette fonction peut être démarrée, qu’une opération de réception correspondante ait été publiée ou non. Il peut terminer l’opération d’envoi avant qu’une réception correspondante ne soit publiée. Son achèvement ne dépend pas de l’occurrence d’une opération de réception correspondante. Si vous appelez cette fonction et qu’aucune opération de réception correspondante n’est publiée, l’implémentation MPI doit mettre en mémoire tampon le message sortant afin que l’appel d’envoi puisse retourner.

Cette fonction retourne une erreur si l’espace de mémoire tampon est insuffisant. La quantité d’espace tampon disponible est contrôlée par l’utilisateur à l’aide de la fonction MPI_Buffer_attach .

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