funzione MPI_Win_attach

Collega un'area di memoria locale per l'accesso remoto all'interno della finestra specificata.

Sintassi

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

Parametri

• win [in]
  Oggetto Window.

• base [in]
  Indirizzo iniziale della memoria da collegare.

• dimensioni [in]
  Dimensione della memoria da collegare in byte.

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

Commenti

Collega un'area di memoria locale a partire dalla base per l'accesso remoto all'interno della finestra specificata. L'area di memoria specificata non deve contenere alcuna parte già collegata alla finestra win, ovvero il collegamento simultaneo di memoria sovrapposta all'interno della stessa finestra è errato. L'argomento win deve essere una finestra creata con MPI_Win_create_dynamic. L'area di memoria locale collegata alla finestra è costituita da byte di dimensioni, a partire dalla base degli indirizzi. In C, base è l'indirizzo iniziale di un'area di memoria. In Fortran è possibile passare il primo elemento di un'area di memoria o un'intera matrice, che deve essere semplicemente contigua. Più aree di memoria (ma non sovrapposte) possono essere collegate alla stessa finestra.

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