Compartilhar via


Função MPI_Irsend

Inicia uma operação de envio de modo pronto e retorna um identificador de solicitação que representa a operação de comunicação.

Sintaxe

int MPIAPI MPI_Irsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           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. O buffer consiste em contar elementos sucessivos do objeto MPI_Datatype indicado pelo identificador de tipo de dados . O comprimento da mensagem é especificado em termos de número de elementos, não em número de bytes. O chamador não deve modificar nenhuma parte do buffer de envio até que a operação de comunicação seja concluída.

  • contagem
    O número de elementos na matriz de buffers. Se count for zero, a parte de dados da mensagem estará vazia.

  • datatype
    Um identificador que representa o tipo de dados dos elementos no buffer.

  • dest
    A classificação do processo de destino dentro do parâmetro comm do comunicador.

  • tag
    A marca de mensagem usada para distinguir diferentes tipos de mensagens.

  • comm
    O identificador para o comunicador.

  • solicitação [out]
    No retorno, um ponteiro para um identificador que representa a operação de comunicação.

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

Comentários

Essa função pode retornar antes que a mensagem seja copiada para fora do buffer de envio. Essa função é local, retorna imediatamente, independentemente da status de outros processos. Consulte os comentários para a função MPI_Rsend para obter a descrição do modo de comunicação pronto.

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_Rsend

MPI_Recv

MPI_Irecv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype