funktionen MPI_Bsend

Skickar data till en angiven process i buffrat läge. Den här funktionen returnerar när sändningsbufferten kan återanvändas på ett säkert sätt.

Syntax

int MPIAPI MPI_Bsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm
);

Parametrar

  • buf [in, optional]
    En pekare till bufferten som innehåller de data som ska skickas.

  • Räkna
    Antalet element i buffertmatrisen. Om datadelen i meddelandet är tom anger du parametern count till 0.

  • Datatyp
    Datatypen för elementen i bufferten.

  • Dest
    Rangordningen för målprocessen i kommunikatören som anges av comm-parametern .

  • Etiketten
    Meddelandetaggen som kan användas för att skilja mellan olika typer av meddelanden.

  • Comm
    Handtaget till kommunikatören.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_BSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

Kommentarer

Den här funktionen är lokal. Den kan slutföra sändningsåtgärden utan att någon matchande mottagningsåtgärd inträffar.

Den här funktionen kan startas oavsett om en matchande mottagningsåtgärd har bokförts eller inte. Den kan slutföra sändningsåtgärden innan en matchande mottagning publiceras. Slutförandet beror inte på förekomsten av en matchande mottagningsåtgärd. Om du anropar den här funktionen och ingen matchande mottagningsåtgärd publiceras måste MPI-implementeringen buffra det utgående meddelandet så att sändningsanropet kan returneras.

Den här funktionen returnerar ett fel om det inte finns tillräckligt med buffertutrymme. Mängden tillgängligt buffertutrymme styrs av användaren med hjälp av funktionen MPI_Buffer_attach .

Krav

Produkt

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities

Huvud

Mpi.h; Mpif.h

Bibliotek

Msmpi.lib

DLL

Msmpi.dll

Se även

MPI punkt-till-punkt-funktioner

MPI_Buffer_attach

MPI_Send

MPI_Ssend

MPI_Rsend

MPI_Recv