Delen via


MPI_Ssend functie

Voert een synchrone verzendbewerking uit en retourneert wanneer de verzendbuffer veilig opnieuw kan worden gebruikt.

Syntaxis

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

Parameters

  • buf [in, optioneel]
    Een aanwijzer naar de buffer die de gegevens bevat die moeten worden verzonden.

  • Tellen
    Het aantal elementen in de buffer. Als het gegevensgedeelte van het bericht leeg is, stelt u de parameter count in op 0.

  • Datatype
    Het gegevenstype van de elementen in de buffer.

  • Dest
    De positie van het doelproces binnen de communicator die is opgegeven door de parameter comm .

  • Tag
    De berichttag die kan worden gebruikt om verschillende typen berichten te onderscheiden.

  • Comm
    Het handvat voor de communicator.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

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

Opmerkingen

Deze functie is niet-lokaal. Een geslaagde voltooiing van de verzendbewerking is afhankelijk van het optreden van een overeenkomende ontvangstfunctie.

Deze functie kan worden aangeroepen, ongeacht of een overeenkomende ontvangst wordt geboekt. De functie Verzenden wordt echter alleen voltooid als er een overeenkomende ontvangst is geboekt en de ontvangstbewerking is gestart met het ontvangen van het bericht. Daarom geeft de voltooiing van een synchrone verzenden niet alleen aan dat de verzendbuffer opnieuw kan worden gebruikt, maar geeft het ook aan dat het ontvangende proces is begonnen met het uitvoeren van de overeenkomende ontvangst.

Als zowel de verzend- als de ontvangstbewerkingen bewerkingen blokkeren, biedt de synchrone modus synchrone communicatie-semantiek; een communicatie aan beide uiteinden wordt pas voltooid als de processen voor verzenden en ontvangen zijn voltooid.

Vereisten

Product

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

Header

Mpi.h; Mpif.h

Bibliotheek

Msmpi.lib

DLL

Msmpi.dll

Zie ook

Punt-naar-punt-functies voor MPI

MPI_Send

MPI_Bsend

MPI_Rsend

MPI_Recv