MPI_Ibcast függvény

A folyamat üzenetét a "root" ranggal szórja a kommunikátor minden más folyamatára, nem blokkoló módon.

Szintaxis

int MPIAPI MPI_Ibcast(
  _Inout_  void        *buffer,
  _In_    int          count,
  _In_    MPI_Datatype datatype,
  _In_    int          root,
  _In_    MPI_Comm     comm,
  _Out_   MPI_Request  *request
);

Paraméterek

• puffer [be, ki]
  Az adatpufferre mutató mutató. A gyökér paraméter által megadott folyamat során a puffer tartalmazza a továbbítandó adatokat. A comm paraméter által megadott kommunikátor összes többi folyamatán a puffer megkapja a gyökérfolyamat által közvetített adatokat. pufferadattípusú leíró által jelzett MPI_Datatype egymást követő elemeiből áll. Az üzenet hosszát az elemek száma, nem a bájtok száma határozza meg.

• darabszám [in]
  A puffer adatelemeinek száma. Ha a paraméter értéke nulla, az üzenet adatrésze üres.

• adattípus [in]
  A MPI_Datatypepufferegyes elemeinek adattípusát jelképező leíró.

• gyökér [in]
  A folyamat rangja a MPI_Commcomm küldi puffert.

• comm [in]
  A MPI_Comm kommunikátor leírója.

• kérelem [ki]
  MPI_Request kommunikációs műveletet jelképező leíró.

Visszaadott é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_IBCAST(BUFFER, COUNT, DATATYPE, ROOT, COMM, REQUEST, IERROR)
        <type> BUFFER(*)  
        INTEGER COUNT, DATATYPE, ROOT, COMM, REQUEST, IERROR

Megjegyzések

A nem blokkoló hívások közös közvetítési műveletet kezdeményeznek, amelyet külön befejező hívásban kell végrehajtani. A kezdeményezést követően a művelet a részt vevő folyamatokban végzett számításoktól vagy egyéb kommunikációtól függetlenül is továbbhaladhat. Ily módon a nem blokkoló közvetítési műveletek a "háttérben" futtatva csökkenthetik a közvetítési műveletek lehetséges szinkronizálási hatásait.

Az összes befejező hívás (például MPI_Wait) támogatott a nem blokkoló szórási műveletekhez.

Követelmények

Termék	Microsoft MPI v6
Fejléc	Mpi.h; Mpif.h
Könyvtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még:

MPI Kollektív függvények

MPI_Bcast

MPI_Datatype

MPI_Test

MPI_Testall

MPI_Testany

MPI_Testsome

MPI_Wait

MPI_Waitall

MPI_Waitany

MPI_Waitsome

MPI_Comm