Partilhar via


função MPI_Win_attach

Anexa uma região de memória local para acesso remoto dentro da janela especificada.

Sintaxe

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

Parâmetros

  • win [in]
    Objeto de janela.

  • base [in]
    Endereço inicial da memória a anexar.

  • tamanho [em]
    Tamanho da memória a anexar em bytes.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro IERROR .

Fortran

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

Observações

Anexa uma região de memória local que começa na base para acesso remoto dentro da janela especificada. A região de memória especificada não pode conter qualquer parte que já esteja ligada à janela win, ou seja, anexar memória sobreposta simultaneamente na mesma janela é errónea. O argumento win tem de ser uma janela criada com MPI_Win_create_dynamic. A região de memória local anexada à janela consiste em bytes de tamanho, começando na base de endereços. Em C, base é o endereço inicial de uma região de memória. Em Fortran, pode-se transmitir o primeiro elemento de uma região de memória ou de uma matriz inteira, que tem de ser simplesmente contígua. Várias regiões de memória (mas não sobrepostas) podem estar ligadas à mesma janela.

Requisitos

Produto

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

Cabeçalho

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Ver também

MPI One-Sided Communications Functions