Partager via


MPI_Win_attach, fonction

Attache une région de mémoire locale pour l’accès à distance dans la fenêtre donnée.

Syntaxe

int MPIAPI MPI_Win_attach(
   MPI_Win  win,
   void*    base,
   MPI_Aint size
);

Paramètres

  • win [in]
    Objet Window.

  • base [in]
    Adresse initiale de la mémoire à attacher.

  • size [in]
    Taille de la mémoire à attacher en octets.

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_ATTACH(WIN, BASE, SIZE, IERROR)
        INTEGER WIN, IERROR
        <type> BASE(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) SIZE

Remarques

Attache une région de mémoire locale commençant à la base pour l’accès à distance dans la fenêtre donnée. La région de mémoire spécifiée ne doit contenir aucune partie déjà attachée à la fenêtre win, c’est-à-dire que l’attachement simultané de la mémoire qui se chevauche dans la même fenêtre est erroné. L’argument win doit être une fenêtre créée avec MPI_Win_create_dynamic. La région de mémoire locale attachée à la fenêtre se compose d’octets de taille, en commençant à la base d’adresse. En C, base est l’adresse de départ d’une région de mémoire. Dans Fortran, vous pouvez passer le premier élément d’une région mémoire ou d’un tableau entier, qui doit être simplement contigu. Plusieurs régions de mémoire (mais qui ne se chevauchent pas) peuvent être attachées à la même fenêtre.

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

Voir aussi

Fonctions de communication One-Sided MPI