funzione MPI_Win_allocate

Crea un oggetto Window MPI che alloca memoria.

Sintassi

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

Parametri

• size
  Dimensioni della finestra di memoria in byte.

• disp_unit
  Dimensioni unità locali per gli spostamenti, in byte.

• Informazioni
  Argomento info.

• Comm
  Communicator.

• baseptr [out]
  Indirizzo iniziale della finestra di memoria.

• win [out]
  Oggetto Window restituito dalla chiamata.

Valore restituito

Restituisce MPI_SUCCESS in caso di esito positivo. In caso contrario, il valore restituito è un codice di errore.

In Fortran il valore restituito viene archiviato nel parametro 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

Commenti

Si tratta di una chiamata collettiva eseguita da tutti i processi nel gruppo di comm. In ogni processo alloca memoria di almeno byte di dimensioni , restituisce un puntatore a esso e restituisce un oggetto finestra che può essere utilizzato da tutti i processi in comm per eseguire operazioni RMA. La memoria restituita è costituita da byte di dimensioni locali per ogni processo, a partire dall'indirizzo baseptr ed è associato alla finestra come se l'utente chiamasse MPI_Win_create sulla memoria esistente. L'argomento size può essere diverso in ogni processo e dimensione = 0 è valido; Tuttavia, una libreria potrebbe allocare ed esporre più memoria per creare un'allocazione simmetrica veloce e globale.

Requisiti

Prodotto	Pacchetto ridistribuibile DI HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o utilità client HPC Pack 2008
Intestazione	Mpi.h; Mpif.h
Libreria	Msmpi.lib
DLL	Msmpi.dll

Vedi anche

Funzioni di comunicazione mpi One-Sided