funktionen MPI_Irecv

Initierar en mottagningsåtgärd och returnerar en referens till den begärda kommunikationsåtgärden.

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
);

Parametrar

• buf [in, optional]
  En pekare till bufferten som innehåller de data som ska skickas.

• Räkna
  Antalet element i buffertmatrisen. Om datadelen i meddelandet är tom anger du parametern count till 0.

• Datatyp
  Datatypen för elementen i bufferten.

• Källkod
  Rangordningen för sändningsprocessen inom den angivna kommunikatören. Ange den MPI_ANY_SOURCE konstanten för att ange att alla källor är godtagbara.

• Etiketten
  Meddelandetaggen som kan användas för att skilja mellan olika typer av meddelanden. Ange MPI_ANY_TAG konstant för att ange att alla taggar är acceptabla.

• Comm
  Handtaget till kommunikatören.

• begäran [ut]
  Vid retur innehåller en referens till den begärda kommunikationsåtgärden.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

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

Kommentarer

Den här funktionen är lokal, den returneras omedelbart och väntar inte på någon annan process. Den här funktionen kan returneras innan meddelandet tas emot i bufferten.

Krav

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities
Huvud	Mpi.h; Mpif.h
Bibliotek	Msmpi.lib
DLL	Msmpi.dll

Se även

MPI punkt-till-punkt-funktioner

MPI_Send

MPI_Recv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype