MPI_Rput, funkcja

Operacja umieszczania RMA oparta na żądaniach.

Składnia

int MPIAPI MPI_Rput(
  _In_  void         *origin_addr,
        int          origin_count,
        MPI_Datatype origin_datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        int          target_count,
        MPI_Datatype target_datatype,
        MPI_Win      win,
  _Out_ MPI_Request  *request
);

Parametry

• origin_addr [in]
  Początkowy adres buforu źródła.

• origin_count
  Liczba wpisów w buforze pochodzenia.

• origin_datatype
  Typ danych każdego wpisu w buforze pochodzenia.

• target_rank
  Ranga elementu docelowego.

• target_disp
  Przesunięcie od początku okna do buforu docelowego.

• target_count
  Liczba wpisów w buforze docelowym.

• target_datatype
  Typ danych każdego wpisu w buforze docelowym.

• Wygrać
  Obiekt okna używany do komunikacji.

• żądanie [out]
  Żądanie RMA.

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_RPUT(ORIGIN_ADDR, ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK,
                TARGET_DISP, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR)
        <type> ORIGIN_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK, TARGET_COUNT,
        TARGET_DATATYPE, WIN, REQUEST, IERROR

Uwagi

MPI_Rput jest podobny do MPI_Put, z tą różnicą, że przydziela obiekt żądania komunikacji i kojarzy go z uchwytem żądania ( żądanie argumentu). Ukończenie operacji MPI_Rput (tj. po odpowiednim teście lub oczekiwaniu) wskazuje, że nadawca może teraz aktualizować lokalizacje w buforze źródła. Nie wskazuje ona, że dane są dostępne w oknie docelowym. Jeśli wymagane jest ukończenie zdalne, można użyć MPI_Win_flush, MPI_Win_flush_all, MPI_Win_unlock lub MPI_Win_unlock_all .

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ż

MPI One-Sided Communications Functions