Compartilhar via


função MPI_Irecv

Inicia uma operação de recebimento e retorna um identificador para a operação de comunicação solicitada.

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 o buffer que contém os dados a serem enviados.

  • contagem
    O número de elementos na matriz de buffers. Se a parte de dados da mensagem estiver vazia, defina o parâmetro count como 0.

  • datatype
    O tipo de dados dos elementos no buffer.

  • source
    A classificação do processo de envio dentro do comunicador especificado. Especifique a constante MPI_ANY_SOURCE para especificar que qualquer fonte é aceitável.

  • tag
    A marca de mensagem que pode ser usada para distinguir diferentes tipos de mensagens. Especifique a constante MPI_ANY_TAG para indicar que qualquer marca é aceitável.

  • comm
    O identificador para o comunicador.

  • solicitação [out]
    No retorno, contém um identificador para a operação de comunicação solicitada.

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

Comentários

Essa função é local, retorna imediatamente e não aguarda nenhum outro processo. Essa função pode retornar antes que a mensagem seja recebida no buffer.

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 ponto a ponto do MPI

MPI_Send

MPI_Recv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype