Delen via


MPI_Irecv functie

Start een ontvangstbewerking en retourneert een ingang naar de aangevraagde communicatiebewerking.

Syntaxis

int MPIAPI MPI_Irecv(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          source,
           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.

  • 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.

  • bron
    De rang van het verzendproces binnen de opgegeven communicator. Geef de MPI_ANY_SOURCE constante op om op te geven dat elke bron acceptabel is.

  • Tag
    De berichttag die kan worden gebruikt om verschillende typen berichten te onderscheiden. Geef de MPI_ANY_TAG constante op om aan te geven dat een tag acceptabel is.

  • Comm
    Het handvat naar de communicator.

  • aanvraag [uit]
    Bij terugkomst bevat een ingang voor de aangevraagde communicatiebewerking.

Retourwaarde

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

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

    MPI_IRECV(BUF, COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR

Opmerkingen

Deze functie is lokaal, retourneert onmiddellijk en wacht niet op een ander proces. Deze functie kan worden geretourneerd voordat het bericht in de buffer wordt ontvangen.

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

MPI-punt-naar-puntfuncties

MPI_Send

MPI_Recv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype