MPI_Win_allocate-Funktion
Erstellt ein MPI Window-Objekt, das Arbeitsspeicher zuordnet.
Syntax
int MPIAPI MPI_Win_allocate(
MPI_Aint size,
int disp_unit,
MPI_Info info,
MPI_Comm comm,
_Out_ void *baseptr,
_Out_ MPI_Win *win
);
Parameter
size
Größe des Speicherfensters in Bytes.disp_unit
Lokale Einheitsgröße für Verschiebungen in Bytes.info
Info-Argument.comm
Communicator.baseptr [out]
Anfangsadresse des Speicherfensters.win [out]
Vom Aufruf zurückgegebenes Window-Objekt.
Rückgabewert
Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.
In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.
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
Hinweise
Dies ist ein kollektiver Aufruf, der von allen Prozessen in der Gruppe von comm ausgeführt wird. Für jeden Prozess weist er Arbeitsspeicher mit mindestens bytesiger Größe zu, gibt einen Zeiger darauf zurück und gibt ein Fensterobjekt zurück, das von allen Prozessen in comm zum Ausführen von RMA-Vorgängen verwendet werden kann. Der zurückgegebene Arbeitsspeicher besteht aus lokalen Bytes für jeden Prozess, beginnend beim Adressbaseptr und ist dem Fenster zugeordnet, als ob der Benutzer MPI_Win_create im vorhandenen Arbeitsspeicher aufgerufen hätte. Das Size-Argument kann bei jedem Prozess unterschiedlich sein, und größe = 0 ist gültig; eine Bibliothek kann jedoch mehr Arbeitsspeicher zuweisen und verfügbar machen, um eine schnelle, global symmetrische Zuordnung zu erstellen.
Anforderungen
Produkt |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliothek |
Msmpi.lib |
DLL |
Msmpi.dll |