MPI_Win_attach functie
Koppelt een lokaal geheugengebied voor externe toegang binnen het opgegeven venster.
Syntaxis
int MPIAPI MPI_Win_attach(
MPI_Win win,
void* base,
MPI_Aint size
);
Parameters
win [in]
Vensterobject.basis [in]
Het oorspronkelijke adres van het geheugen dat moet worden gekoppeld.grootte [in]
Grootte van het geheugen dat in bytes moet worden gekoppeld.
Retourwaarde
Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.
In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .
Fortran
MPI_WIN_ATTACH(WIN, BASE, SIZE, IERROR)
INTEGER WIN, IERROR
<type> BASE(*)
INTEGER(KIND=MPI_ADDRESS_KIND) SIZE
Opmerkingen
Koppelt een lokaal geheugengebied vanaf de basis voor externe toegang binnen het opgegeven venster. Het opgegeven geheugengebied mag geen deel bevatten dat al is gekoppeld aan de venster-win, dat wil gezegd dat het koppelen van overlappend geheugen gelijktijdig binnen hetzelfde venster onjuist is. Het argument win moet een venster zijn dat is gemaakt met MPI_Win_create_dynamic. De lokale geheugenregio die aan het venster is gekoppeld, bestaat uit grootte bytes, beginnend bij adresbasis. In C is basis het beginadres van een geheugenregio. In Fortran kan men het eerste element van een geheugengebied of een hele matrix doorgeven, die eenvoudig aaneengesloten moet zijn. Meerdere (maar niet-overlappende) geheugengebieden kunnen aan hetzelfde venster zijn gekoppeld.
Vereisten
Product |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliotheek |
Msmpi.lib |
DLL |
Msmpi.dll |