função MPI_Cancel

Cancela um pedido de comunicação.

Sintaxe

int MPIAPI MPI_Cancel(
  _In_ MPI_Request *request
);

Parâmetros

• pedido [em]
  Pedido 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_CANCEL(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

Observações

A utilização esperada principal de MPI_Cancel é em esquemas de multi-memória intermédia, onde são feitas MPI_Irecvespeculativas. Quando a computação for concluída, alguns destes pedidos de receção poderão permanecer; a utilização de MPI_Cancel permite ao utilizador cancelar estes pedidos não satisfeitos.

Cancelar uma operação de envio é muito mais difícil, em grande parte porque o envio será normalmente pelo menos parcialmente concluído (as informações sobre a etiqueta, o tamanho e a origem são normalmente enviadas imediatamente para o destino). Os utilizadores são avisados de que o cancelamento de um envio, enquanto uma operação local (conforme definido pela norma MPI), é provável que seja dispendioso (normalmente, gerando uma ou mais mensagens internas).

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