MPI_Rget, funkcja

Operacja pobierania RMA oparta na żądaniach.

Składnia

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

Parametry

• origin_addr [out]
  Adres buforu, w którym mają zostać odebrane dane.

• origin_count
  Liczba wpisów w buforze źródła.

• origin_datatype
  Typ danych każdego wpisu w buforze źródła.

• target_rank
  Ranga miejsca docelowego.

• target_disp
  Odsunięcia od okna do początku buforu docelowego.

• target_count
  Liczba wpisów w buforze docelowym.

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

• Wygrać
  Obiekt okna używany do komunikacji.

• request [out]
  Żądanie RMA.

Wartość zwracana

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

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

Fortran

    MPI_RGET(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_Rget jest podobna do MPI_Get, z tą różnicą, że przydziela obiekt żądania komunikacji i kojarzy go z dojściem żądania ( żądanie argumentu), którego można użyć do oczekiwania lub przetestowania ukończenia. Ukończenie operacji MPI_Rget wskazuje, że dane są dostępne w buforze źródła. Jeśli origin_addr wskazuje pamięć dołączoną do okna, dane staną się dostępne w prywatnej kopii tego okna.

Wymagania

Produkt	Pakiet redystrybucyjny PROGRAMU HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny PAKIETU HPC Pack 2008 MS-MPI lub narzędzia klienckie PAKIETU HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

MPI One-Sided Communications Functions