função MPI_Win_attach

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

Sintaxe

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

Parâmetros

• win [in]
  Objeto Window.

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

• size [in]
  Tamanho da memória a ser anexada em bytes.

Retornar valor

Retorna MPI_SUCCESS em caso de êxito. Caso contrário, o valor retornado será um código de erro.

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

Fortran

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

Comentários

Anexa uma região de memória local começando na base para acesso remoto dentro da janela fornecida. A região de memória especificada não deve conter nenhuma parte que já esteja anexada ao win da janela, ou seja, anexar memória sobreposta simultaneamente dentro da mesma janela é incorreto. O argumento win deve ser uma janela que foi 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. No Fortran, é possível passar o primeiro elemento de uma região de memória ou de uma matriz inteira, que deve ser simplesmente contígua. Várias regiões de memória (mas não sobrepostas) podem ser anexadas à mesma janela.

Requisitos

Produto	Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008
parâmetro	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
DLL	Msmpi.dll

Confira também

Funções de comunicação de One-Sided MPI