MPI_Win_allocate, fonction
Crée un objet Window MPI qui alloue de la mémoire.
Syntaxe
int MPIAPI MPI_Win_allocate(
MPI_Aint size,
int disp_unit,
MPI_Info info,
MPI_Comm comm,
_Out_ void *baseptr,
_Out_ MPI_Win *win
);
Paramètres
size
Taille de la fenêtre mémoire en octets.disp_unit
Taille d’unité locale pour les déplacements, en octets.info
Argument Info.comm
Communicateur.baseptr [out]
Adresse initiale de la fenêtre mémoire.win [out]
Objet window retourné par l’appel.
Valeur retournée
Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.
Dans Fortran, la valeur de retour est stockée dans le paramètre IERROR .
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
Remarques
Il s’agit d’un appel collectif exécuté par tous les processus du groupe de comm. Sur chaque processus, il alloue de la mémoire d’une taille minimale d’octets, retourne un pointeur vers celui-ci et retourne un objet de fenêtre qui peut être utilisé par tous les processus de comm pour effectuer des opérations RMA. La mémoire retournée se compose d’octets de taille locale pour chaque processus, en commençant à baseptr d’adresse et est associée à la fenêtre comme si l’utilisateur appelait MPI_Win_create sur la mémoire existante. L’argument size peut être différent à chaque processus et la taille = 0 est valide ; Toutefois, une bibliothèque peut allouer et exposer davantage de mémoire afin de créer une allocation symétrique globale et rapide.
Configuration requise
Produit |
Package redistribuable MS-MPI HPC Pack 2012, package redistribuable HPC Pack 2008 R2 MS-MPI, package redistribuable MS-MPI HPC Pack 2008 ou utilitaires clients HPC Pack 2008 |
En-tête |
Mpi.h ; Mpif.h |
Bibliothèque |
Msmpi.lib |
DLL |
Msmpi.dll |