MPI_Win_lock functie
Begint een RMA-toegangstijdperk bij het doelproces.
Syntaxis
int MPIAPI MPI_Win_lock(
int lock_type,
int rank,
int assert,
MPI_Win win
);
Parameters
lock_type
Geeft aan of andere processen tegelijkertijd toegang hebben tot het doelvenster (als MPI_LOCK_SHARED) of niet (MPI_LOCK_EXCLUSIVE).Rang
Rang van vergrendeld venster.Beweren
Wordt gebruikt om deze aanroep te optimaliseren; nul kan standaard worden gebruikt.Winnen
Vensterobject.
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_LOCK(LOCK_TYPE, RANK, ASSERT, WIN, IERROR)
INTEGER LOCK_TYPE, RANK, ASSERT, WIN, IERROR
Opmerkingen
De naam van deze routine is misleidend. Deze routine hoeft met name niet te worden geblokkeerd, behalve wanneer het doelproces het aanroepende proces is.
Implementaties kunnen het gebruik beperken van RMA-communicatie die wordt gesynchroniseerd door vergrendelingsoproepen naar vensters in het geheugen dat is toegewezen door MPI_Alloc_mem. Vergrendelingen kunnen alleen portabiliteit worden gebruikt in een dergelijk geheugen.
Het argument assert wordt gebruikt om speciale voorwaarden aan te geven voor de omheining die een implementatie kan gebruiken om de MPI_Win_fence bewerking te optimaliseren. De waarde nul is altijd juist. Andere assertiewaarden kunnen OFsamen zijn. Asserties die geldig zijn voor MPI_Win_fence zijn:
- MPI_MODE_NOCHECK : geen ander proces bevat of probeert een conflicterende vergrendeling te verkrijgen, terwijl de aanroeper de venstervergrendeling vasthoudt. Dit is handig wanneer wederzijdse uitsluiting op andere manieren wordt bereikt, maar de coherentiebewerkingen die aan de vergrendelings- en ontgrendelingsgesprekken kunnen worden gekoppeld, nog steeds vereist zijn.
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 |