Delen via


MPI_Bsend functie

Hiermee worden gegevens verzonden naar een opgegeven proces in de gebufferde modus. Deze functie retourneert wanneer de verzendbuffer veilig opnieuw kan worden gebruikt.

Syntaxis

int MPIAPI MPI_Bsend(
  _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 buffermatrix. 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_BSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

Opmerkingen

Deze functie is lokaal en kan de verzendbewerking met succes voltooien zonder dat er een overeenkomende ontvangstbewerking plaatsvindt.

Deze functie kan worden gestart, ongeacht of er een overeenkomende ontvangstbewerking is geboekt. De verzendbewerking kan worden voltooid voordat een overeenkomende ontvangst wordt geboekt. De voltooiing ervan is niet afhankelijk van het optreden van een overeenkomende ontvangstbewerking. Als u deze functie aanroept en er geen overeenkomende ontvangstbewerking wordt geboekt, moet de MPI-implementatie het uitgaande bericht bufferen, zodat de oproep kan worden verzonden.

Deze functie retourneert een fout als er onvoldoende bufferruimte is. De hoeveelheid beschikbare bufferruimte wordt beheerd door de gebruiker met behulp van de functie MPI_Buffer_attach .

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_Buffer_attach

MPI_Send

MPI_Ssend

MPI_Rsend

MPI_Recv