MPI_Win_allocate_shared funkce

Vytvoří objekt okna MPI, který přiděluje paměť, přidělená paměť může být přístupná ze všech procesů ve skupině okna s přímým načtením a uložením pokynů.

Syntaxe

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

Parametry

• Velikost
  Velikost okna paměti v bajtech

• disp_unit
  Velikost místní jednotky pro posunutí v bajtech.

• Info
  Argument informace.

• Komunikace
  V rámci komunikátoru.

• baseptr [out]
  Adresa místně přiděleného segmentu okna.

• win [out]
  Objekt Okna vrácený voláním.

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

V nástroji Fortran je vrácená hodnota uložena v parametru IERROR .

Fortran

    MPI_WIN_ALLOCATE_SHARED(SIZE, DISP_UNIT, INFO, COMM, BASEPTR, WIN, IERROR)
        <type> BASEPTR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) SIZE
        INTEGER DISP_UNIT, INFO, COMM, WIN, IERROR

Poznámky

Toto je kolektivní volání prováděné všemi procesy ve skupině čárky. Pro každý proces přiděluje paměť alespoň o velikosti bajtů, která je sdílena mezi všemi procesy v comm, a vrátí ukazatel na místně přidělený segment v baseptru , který lze použít pro přístupy k načtení/úložišti ve volajícím procesu. Místně přidělená paměť může být cílem přístupu k zatížení/úložišti vzdálenými procesy. základní ukazatele pro jiné procesy lze dotazovat pomocí funkce MPI_Win_shared_query. Volání také vrátí objekt okna, který může být použit všemi procesy v comm k provádění operací RMA. Argument size se může v každém procesu lišit a velikost = 0 je platná. Je zodpovědností uživatele zajistit, aby komunikátor comm představoval skupinu procesů, které mohou vytvořit sdílený segment paměti, ke kterému budou mít přístup všechny procesy ve skupině.

Požadavky

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package nebo HPC Pack 2008 Client Utilities
Hlavička	Mpi.h; Mpif.h
Knihovna	Msmpi.lib
DLL	Msmpi.dll

Viz také

Funkce MPI One-Sided Communications