Partilhar via


função MPI_Irsend

Inicia uma operação de envio do modo pronto e devolve um identificador de pedido 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 a memória intermédia que contém os dados a enviar. A memória intermédia consiste em contar elementos sucessivos do objeto MPI_Datatype que é 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 autor da chamada não deve modificar qualquer parte da memória intermédia de envio até que a operação de comunicação esteja concluída.

  • contagem
    O número de elementos na matriz de memória intermédia. Se a contagem for zero, a parte dos dados da mensagem está vazia.

  • tipo de dados
    Um identificador que representa o tipo de dados dos elementos na memória intermédia.

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

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

  • vírgula
    A alça do comunicador.

  • pedido [fora]
    Na devolução, um ponteiro para um identificador que representa a operação de comunicação.

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

Observações

Esta função pode devolver antes de a mensagem ser copiada da memória intermédia de envio. Esta função é local, devolve imediatamente, independentemente do estado de outros processos. Veja as observações da função MPI_Rsend para obter a descrição do modo de comunicação pronto.

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_Rsend

MPI_Recv

MPI_Irecv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype