Dela via


funktionen MPI_Win_attach

Ansluter ett lokalt minnesområde för fjärråtkomst inom det angivna fönstret.

Syntax

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

Parametrar

  • win [in]
    Fönsterobjekt.

  • bas [in]
    Ursprunglig adress för det minne som ska kopplas.

  • storlek [i]
    Storleken på det minne som ska kopplas i byte.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_WIN_ATTACH(WIN, BASE, SIZE, IERROR)
        INTEGER WIN, IERROR
        <type> BASE(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) SIZE

Kommentarer

Ansluter ett lokalt minnesområde som börjar vid basen för fjärråtkomst i det angivna fönstret. Det angivna minnesområdet får inte innehålla någon del som redan är kopplad till fönstervinsten, det vill säga att koppla överlappande minne samtidigt inom samma fönster är felaktigt. Argumentvinsten måste vara ett fönster som skapades med MPI_Win_create_dynamic. Det lokala minnesområdet som är kopplat till fönstret består av bytestorlekar, med början vid adressbasen. I C är basen startadressen för en minnesregion. I Fortran kan man skicka det första elementet i en minnesregion eller en hel matris, som helt enkelt måste vara sammanhängande. Flera (men icke-överlappande) minnesregioner kan kopplas till samma fönster.

Krav

Produkt

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities

Huvud

Mpi.h; Mpif.h

Bibliotek

Msmpi.lib

DLL

Msmpi.dll

Se även

MPI One-Sided Communications Functions