MPI_Win_allocate_shared functie
Hiermee maakt u een MPI-vensterobject dat geheugen toewijst. Toegewezen geheugen kan worden geopend vanuit alle processen in de groep van het venster met instructies voor direct laden/opslaan.
Syntaxis
int MPIAPI MPI_Win_allocate_shared(
MPI_Aint size,
int disp_unit,
MPI_Info info,
MPI_Comm comm,
_Out_ void *baseptr,
_Out_ MPI_Win *win
);
Parameters
Grootte
Grootte van het geheugenvenster in bytes.disp_unit
Lokale eenheidsgrootte voor verplaatsingen, in bytes.Info
Infoargument.Comm
Intra-communicator.baseptr [uit]
Adres van lokaal toegewezen venstersegment.win [uit]
Vensterobject geretourneerd door de aanroep.
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_ALLOCATE_SHARED(SIZE, DISP_UNIT, INFO, COMM, BASEPTR, WIN, IERROR)
<type> BASEPTR(*)
INTEGER(KIND=MPI_ADDRESS_KIND) SIZE
INTEGER DISP_UNIT, INFO, COMM, WIN, IERROR
Opmerkingen
Dit is een collectieve aanroep die wordt uitgevoerd door alle processen in de groep van comm. Bij elk proces wijst het geheugen van minimaal bytesgrootte toe dat wordt gedeeld tussen alle processen in comm en retourneert een aanwijzer naar het lokaal toegewezen segment in baseptr dat kan worden gebruikt voor het laden/opslaan van toegang tot het aanroepende proces. Het lokaal toegewezen geheugen kan het doel zijn van laad-/opslagtoegang via externe processen; de basispointers voor andere processen kunnen worden opgevraagd met behulp van de functie MPI_Win_shared_query. De aanroep retourneert ook een vensterobject dat door alle processen in comm kan worden gebruikt om RMA-bewerkingen uit te voeren. Het argument grootte kan bij elk proces verschillen en grootte = 0 is geldig. Het is de verantwoordelijkheid van de gebruiker om ervoor te zorgen dat de communicator comm een groep processen vertegenwoordigt die een gedeeld geheugensegment kunnen maken dat toegankelijk is voor alle processen in de groep.
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 |