função MPI_Irecv

Artigo
12/27/2023

Inicia uma operação de receção e devolve um identificador para a operação de comunicação pedida.

Sintaxe

int MPIAPI MPI_Irecv(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          source,
           int          tag,
           MPI_Comm     comm,
  _Out_    MPI_Request  *request
);

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 matriz de 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.
origem
A classificação do processo de envio no comunicador especificado. Especifique a constante MPI_ANY_SOURCE para especificar que qualquer origem é aceitável.
etiqueta
A etiqueta de mensagem que pode ser utilizada para distinguir diferentes tipos de mensagens. Especifique a constante MPI_ANY_TAG para indicar que qualquer etiqueta é aceitável.
vírgula
A alça do comunicador.
pedido [fora]
Na devolução, contém um identificador para a operação de comunicação pedida.

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

Observações

Esta função é local, devolve imediatamente e não aguarda por qualquer outro processo. Esta função pode devolver antes de a mensagem ser recebida na memória intermédia.

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