Udostępnij za pośrednictwem


MPI_Win_attach, funkcja

Dołącza lokalny region pamięci na potrzeby dostępu zdalnego w danym oknie.

Składnia

int MPIAPI MPI_Win_attach(
   MPI_Win  win,
   void*    base,
   MPI_Aint size
);

Parametry

  • win [in]
    Obiekt okna.

  • base [in]
    Początkowy adres pamięci do dołączenia.

  • size [in]
    Rozmiar pamięci do dołączenia w bajtach.

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_WIN_ATTACH(WIN, BASE, SIZE, IERROR)
        INTEGER WIN, IERROR
        <type> BASE(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) SIZE

Uwagi

Dołącza lokalny region pamięci rozpoczynający się od podstawy na potrzeby dostępu zdalnego w danym oknie. Określony region pamięci nie może zawierać żadnej części, która jest już dołączona do wygranej okna, czyli dołączanie nakładającej się pamięci współbieżnie w tym samym oknie jest błędne. Wygrana argumentu musi być oknem utworzonym za pomocą MPI_Win_create_dynamic. Region pamięci lokalnej dołączony do okna składa się z bajtów o rozmiarze, począwszy od podstawy adresów. W języku C podstawowy jest adresem początkowym regionu pamięci. W Fortran można przekazać pierwszy element regionu pamięci lub całą tablicę, która musi być po prostu ciągła. Wiele (ale nienakładalnych) regionów pamięci może być dołączonych do tego samego 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