Compartilhar via

função MPI_Cancel

  • Artigo

Cancela uma solicitação de comunicação.

Sintaxe

int MPIAPI MPI_Cancel(
  _In_ MPI_Request *request
);

Parâmetros

  • request [in]
    Solicitação de comunicação.

Retornar valor

Retorna MPI_SUCCESS com êxito. Caso contrário, o valor retornado será um código de erro.

No Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

    MPI_CANCEL(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

Comentários

O principal uso esperado de MPI_Cancel está em esquemas de vários buffers, em que sãofeitas MPI_Irecv especulativas. Quando a computação for concluída, algumas dessas solicitações de recebimento poderão permanecer; usando MPI_Cancel permite que o usuário cancele essas solicitações insatisfatórios.

Cancelar uma operação de envio é muito mais difícil, em grande parte porque o envio geralmente será pelo menos parcialmente concluído (as informações sobre a marca, o tamanho e a origem geralmente são enviadas imediatamente para o destino). Os usuários são avisados de que cancelar um envio, enquanto uma operação local (conforme definido pelo padrão MPI), provavelmente será caro (geralmente gerando uma ou mais mensagens internas).

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 de MPI