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 |