Udostępnij za pośrednictwem


MPI_Irecv, funkcja

Inicjuje operację odbierania i zwraca uchwyt do żądanej operacji komunikacji.

Składnia

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

Parametry

  • buf [in, opcjonalnie]
    Wskaźnik do buforu zawierającego dane do wysłania.

  • Liczba
    Liczba elementów w tablicy buforów. Jeśli część danych komunikatu jest pusta, ustaw parametr count na 0.

  • Datatype
    Typ danych elementów w buforze.

  • Źródła
    Ranga procesu wysyłania w określonym komunikatorze. Określ stałą MPI_ANY_SOURCE , aby określić, że dowolne źródło jest dopuszczalne.

  • Tag
    Tag komunikatu, który może służyć do rozróżniania różnych typów komunikatów. Określ stałą MPI_ANY_TAG , aby wskazać, że dowolny tag jest akceptowalny.

  • Comm
    Uchwyt do komunikatora.

  • żądanie [out]
    Po powrocie zawiera dojście do żądanej operacji komunikacji.

Wartość zwracana

Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze IERROR .

Fortran

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

Uwagi

Ta funkcja jest lokalna, zwraca natychmiast i nie czeka na żaden inny proces. Ta funkcja może wrócić przed odebraniem komunikatu do buforu.

Wymagania

Produkt

Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008

Nagłówek

Mpi.h; Mpif.h

Biblioteka

Msmpi.lib

DLL

Msmpi.dll

Zobacz też

Funkcje punkt-punkt MPI

MPI_Send

MPI_Recv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype