MPI_Win_allocate, funkcja

Tworzy obiekt okna MPI, który przydziela pamięć.

Składnia

int MPIAPI MPI_Win_allocate(
        MPI_Aint size,
        int      disp_unit,
        MPI_Info info,
        MPI_Comm comm,
  _Out_ void     *baseptr,
  _Out_ MPI_Win  *win
);

Parametry

• Rozmiar
  Rozmiar okna pamięci w bajtach.

• disp_unit
  Rozmiar jednostki lokalnej dla wysiedleń w bajtach.

• informacje o
  Argument informacji.

• Comm
  Communicator.

• baseptr [out]
  Początkowy adres okna pamięci.

• win [out]
  Obiekt okna zwrócony przez wywołanie .

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_ALLOCATE(SIZE, DISP_UNIT, INFO, COMM, BASEPTR, WIN, IERROR)
        <type> BASEPTR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) SIZE
        INTEGER DISP_UNIT, INFO, COMM, WIN, IERROR

Uwagi

Jest to zbiorcze wywołanie wykonywane przez wszystkie procesy w grupie comm. W każdym procesie przydziela pamięć o rozmiarze co najmniej bajtów, zwraca wskaźnik do niego i zwraca obiekt okna, który może być używany przez wszystkie procesy w comm do wykonywania operacji RMA. Zwrócona pamięć składa się z rozmiaru bajtów lokalnych dla każdego procesu, począwszy od baseptr adresu i jest skojarzony z oknem tak, jakby użytkownik o nazwie MPI_Win_create w istniejącej pamięci. Argument rozmiaru może być inny w każdym procesie i rozmiar = 0 jest prawidłowy; jednak biblioteka może przydzielić i uwidocznić więcej pamięci, aby utworzyć szybką, globalnie symetryczną alokację.

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