Compartilhar via


função MPI_Rget

Operação de obtenção de RMA baseada em solicitação.

Sintaxe

int MPIAPI MPI_Rget(
  _Out_ void         *origin_addr,
        int          origin_count,
        MPI_Datatype origin_datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        int          target_count,
        MPI_Datatype datatype,
        MPI_Win      win,
  _Out_ MPI_Request  *request
);

Parâmetros

  • origin_addr [out]
    Endereço do buffer no qual receber os dados.

  • origin_count
    Número de entradas no buffer de origem.

  • origin_datatype
    Tipo de dados de cada entrada no buffer de origem.

  • target_rank
    Classificação de destino.

  • target_disp
    O deslocamento da janela começa até o início do buffer de destino.

  • target_count
    Número de entradas no buffer de destino.

  • datatype
    Tipo de dados de cada entrada no buffer de destino.

  • win
    Objeto window usado para comunicação.

  • solicitação [out]
    Solicitação de RMA.

Retornar valor

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

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

Fortran

    MPI_RGET(ORIGIN_ADDR, ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK,
                TARGET_DISP, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR)
        <type> ORIGIN_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR

Comentários

MPI_Rget é semelhante a MPI_Get, exceto por alocar um objeto de solicitação de comunicação e associá-lo ao identificador de solicitação (a solicitação de argumento) que pode ser usado para aguardar ou testar a conclusão. A conclusão de uma operação de MPI_Rget indica que os dados estão disponíveis no buffer de origem. Se origin_addr apontar para a memória anexada a uma janela, os dados ficarão disponíveis na cópia privada dessa 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

MPI One-Sided Communications Functions