MPI_Win_allocate funkce

Vytvoří objekt okna MPI, který přiděluje paměť.

Syntaxe

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

• Velikost
  Velikost okna paměti v bajtech

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

• Info
  Argument informace.

• Komunikace
  Communicator.

• baseptr [out]
  Počáteční adresa okna paměti.

• 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(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. U každého procesu přiděluje paměť alespoň o velikosti bajtů, vrátí na ni ukazatel a vrátí objekt okna, který mohou používat všechny procesy v comm k provádění operací RMA. Vrácená paměť se skládá z bajtů velikosti místních pro každý proces, počínaje baseptrem adresy a je přidružena k oknem, jako by uživatel volal MPI_Win_create na existující paměti. Argument size se může v každém procesu lišit a velikost = 0 je platná; Knihovna však může přidělit a vystavit více paměti, aby se vytvořilo rychlé a globálně symetrické přidělení.

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