Megosztás:


MPI_Bsend függvény

Adatokat küld egy megadott folyamatnak pufferelt módban. Ez a függvény akkor ad vissza, ha a küldési puffer biztonságosan újra felhasználható.

Szintaxis

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

Paraméterek

  • buf [in, nem kötelező]
    Az elküldendő adatokat tartalmazó pufferre mutató mutató.

  • Számít
    A puffertömb elemeinek száma. Ha az üzenet adatrésze üres, állítsa a count paramétert 0-ra.

  • Adattípus
    A puffer elemeinek adattípusa.

  • dest
    A comm paraméter által megadott célfolyamat rangja a kommunikátorban.

  • Tag
    A különböző típusú üzenetek megkülönböztetésére használható üzenetcímke.

  • Comm
    A kommunikátor fogantyúja.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben van tárolva.

Fortran

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

Megjegyzések

Ez a függvény helyi, sikeresen végrehajthatja a küldési műveletet egyező fogadási művelet előfordulása nélkül.

Ez a függvény elindítható, függetlenül attól, hogy egy megfelelő fogadási művelet lett-e közzétéve. A küldési műveletet a megfelelő fogadás közzététele előtt hajthatja végre. A művelet befejezése nem függ a megfelelő fogadási művelet előfordulásától. Ha meghívja ezt a függvényt, és nem jelenik meg egyező fogadási művelet, az MPI-implementációnak pufferelnie kell a kimenő üzenetet, hogy a küldési hívás vissza tud térni.

Ez a függvény hibát ad vissza, ha nincs elegendő pufferterület. A rendelkezésre álló pufferterület mennyiségét a felhasználó szabályozza a MPI_Buffer_attach függvénnyel.

Követelmények

Termék

HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI újraterjeszthető csomag vagy HPC Pack 2008 ügyfél-segédprogramok

Fejléc

Mpi.h; Mpif.h

Kódtár

Msmpi.lib

DLL

Msmpi.dll

Lásd még

MPI pont–pont függvények

MPI_Buffer_attach

MPI_Send

MPI_Ssend

MPI_Rsend

MPI_Recv