função MPI_Ssend

Artigo
08/14/2023

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

Sintaxe

int MPIAPI MPI_Ssend(
  _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 de 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_SSEND(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 bem-sucedida da operação de envio depende da ocorrência de uma função de receção correspondente.

Esta função pode ser chamada se uma receção correspondente é ou não publicada. No entanto, a função de envio só é concluída com êxito se for publicada uma receção correspondente e a operação de receção tiver começado a receber a mensagem. Por conseguinte, a conclusão de um envio síncrono não só indica que a memória intermédia de envio pode ser reutilizada, como também indica que o processo de receção começou a executar a receção correspondente.

Se as operações de envio e receção estiverem a bloquear operações, o modo síncrono fornece semântica de comunicação síncrona; uma comunicação não é concluída em nenhuma das extremidades até que os processos de envio e receção estejam concluídos.

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