Freigeben über


MPI_Irecv-Funktion

Initiiert einen Empfangsvorgang und gibt ein Handle an den angeforderten Kommunikationsvorgang zurück.

Syntax

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

Parameter

  • buf [in, optional]
    Ein Zeiger auf den Puffer, der die zu sendenden Daten enthält.

  • count
    Die Anzahl der Elemente im Pufferarray. Wenn der Datenteil der Nachricht leer ist, legen Sie den count-Parameter auf 0 fest.

  • datatype
    Der Datentyp der Elemente im Puffer.

  • source
    Der Rang des Sendeprozesses innerhalb des angegebenen Kommunikators. Geben Sie die MPI_ANY_SOURCE Konstante an, um anzugeben, dass eine beliebige Quelle akzeptabel ist.

  • tag
    Das Nachrichtentag, mit dem verschiedene Nachrichtentypen unterschieden werden können. Geben Sie die MPI_ANY_TAG Konstante an, um anzugeben, dass ein beliebiges Tag akzeptabel ist.

  • comm
    Das Handle für den Communicator.

  • Request [out]
    Enthält bei der Rückgabe ein Handle für den angeforderten Kommunikationsvorgang.

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

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

Hinweise

Diese Funktion ist lokal, gibt sofort zurück und wartet nicht auf einen anderen Prozess. Diese Funktion kann zurückgegeben werden, bevor die Nachricht in den Puffer empfangen wird.

Anforderungen

Produkt

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

Header

Mpi.h; Mpif.h

Bibliothek

Msmpi.lib

DLL

Msmpi.dll

Weitere Informationen

MPI-Punkt-zu-Punkt-Funktionen

MPI_Send

MPI_Recv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype