Delen via


MPI_Irsend functie

Hiermee start u een verzendbewerking in de gereedheidsmodus en retourneert u een aanvraagingang die de communicatiebewerking vertegenwoordigt.

Syntaxis

int MPIAPI MPI_Irsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm,
  _Out_    MPI_Request  *request
);

Parameters

  • buf [in, optioneel]
    Een aanwijzer naar de buffer die de gegevens bevat die moeten worden verzonden. De buffer bestaat uit het aantal opeenvolgende elementen van het MPI_Datatype-object dat wordt aangegeven door de gegevenstype-ingang . De berichtlengte wordt opgegeven in termen van het aantal elementen, niet in het aantal bytes. De aanroeper mag geen deel van de verzendbuffer wijzigen totdat de communicatiebewerking is voltooid.

  • Tellen
    Het aantal elementen in de buffermatrix. Als het aantal nul is, is het gegevensgedeelte van het bericht leeg.

  • Datatype
    Een ingang die het gegevenstype van de elementen in de buffer vertegenwoordigt.

  • Dest
    De rang van het doelproces binnen de parameter Communicator comm .

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

  • Comm
    Het handvat voor de communicator.

  • aanvraag [uit]
    Bij terugkomst een aanwijzer naar een ingang die de communicatiebewerking vertegenwoordigt.

Retourwaarde

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

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

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

Opmerkingen

Deze functie kan worden geretourneerd voordat het bericht uit de verzendbuffer is gekopieerd. Deze functie is lokaal en retourneert onmiddellijk, ongeacht de status van andere processen. Zie de opmerkingen bij de functie MPI_Rsend voor de beschrijving van de gereedheidscommunicatiemodus.

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_Rsend

MPI_Recv

MPI_Irecv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype