Partilhar via


função MPI_Send

Executa uma operação de envio de modo padrão e devolve quando a memória intermédia de envio pode ser reutilizada com segurança.

Sintaxe

int MPIAPI MPI_Send(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm
);

Parâmetros

  • buf [in, opcional]
    Um ponteiro para a memória intermédia que contém os dados a enviar.

  • contagem
    O número de elementos na memória intermédia. Se a parte dos dados da mensagem estiver vazia, defina o parâmetro de contagem como 0.

  • tipo de dados
    O tipo de dados dos elementos na memória intermédia.

  • dest
    A classificação do processo de destino no comunicador especificado pelo parâmetro de comunicação .

  • etiqueta
    A etiqueta de mensagem que pode ser utilizada para distinguir diferentes tipos de mensagens.

  • vírgula
    A alça do comunicador.

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_SEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

Observações

Esta função não é local. A conclusão com êxito pode depender da existência de uma função de receção correspondente.

Esta função pode devolver antes de uma função de receção correspondente ser invocada se a implementação do MPI colocar a mensagem na memória intermédia. No entanto, o espaço na memória intermédia pode não estar disponível ou as mensagens a enviar podem não estar em memória intermédia por motivos de desempenho. Se a mensagem não estiver em memória intermédia, a função só será devolvida depois de os dados serem movidos para o processo de receção.

Esta função pode ser chamada quer seja ou não publicada uma função de receção correspondente. Pode terminar antes de ser publicada uma função de receção correspondente.

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

Funções Ponto a Ponto do MPI

MPI_Bsend

MPI_Rsend

MPI_Ssend

MPI_Recv