Sdílet prostřednictvím


MPI_Ssend funkce

Provede operaci odeslání v synchronním režimu a vrátí se, pokud lze vyrovnávací paměť pro odesílání bezpečně znovu použít.

Syntaxe

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

Parametry

  • buf [in, optional]
    Ukazatel na vyrovnávací paměť obsahující data, která mají být odeslána.

  • Počet
    Počet prvků ve vyrovnávací paměti. Pokud je datová část zprávy prázdná, nastavte parametr count na 0.

  • Datatype
    Datový typ prvků ve vyrovnávací paměti.

  • Dest
    Pořadí cílového procesu v rámci komunikátoru, které je určeno parametrem comm .

  • Značku
    Značka zprávy, kterou lze použít k rozlišení různých typů zpráv.

  • Komunikace
    Popisovač komunikátoru.

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

Ve Fortranu je vrácená hodnota uložena v parametru IERROR .

Fortran

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

Poznámky

Tato funkce není místní. Úspěšné dokončení operace odeslání závisí na výskytu odpovídající funkce příjmu.

Tuto funkci je možné volat bez ohledu na to, jestli se publikuje odpovídající příjem. Funkce send je však úspěšně dokončena pouze v případě, že je odeslán odpovídající příjem a operace příjmu začala přijímat zprávu. Proto dokončení synchronního odesílání nejen indikuje, že vyrovnávací paměť pro odesílání lze znovu použít, ale také indikuje, že proces přijímání začal provádět odpovídající příjem.

Pokud jsou operace odesílání a přijímání blokující operace, pak synchronní režim poskytuje synchronní sémantiku komunikace; komunikace není na obou stranách dokončena, dokud se nedokončí procesy odesílání a přijímání.

Požadavky

Produkt

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

Hlavička

Mpi.h; Soubor Mpif.h

Knihovna

Msmpi.lib

DLL

Msmpi.dll

Viz také

Funkce MPI typu point-to-point

MPI_Send

MPI_Bsend

MPI_Rsend

MPI_Recv