MPI_Cancel, funkcja
Anuluje żądanie komunikacji.
Składnia
int MPIAPI MPI_Cancel(
_In_ MPI_Request *request
);
Parametry
-
żądanie [in]
Żądanie komunikacji.
Wartość zwracana
Zwraca MPI_SUCCESS powodzenia. W przeciwnym razie wartość zwracana jest kodem błędu.
W fortran wartość zwracana jest przechowywana w parametrze IERROR .
Fortran
MPI_CANCEL(REQUEST, IERROR)
INTEGER REQUEST, IERROR
Uwagi
Podstawowym oczekiwanym zastosowaniem MPI_Cancel jest schematy wielobuforowe, w których są wykonywane MPI_Irecvspekulacyjne. Po zakończeniu obliczeń niektóre z tych żądań odbioru mogą pozostać; korzystanie z MPI_Cancel umożliwia użytkownikowi anulowanie tych niezadowolonych żądań.
Anulowanie operacji wysyłania jest znacznie trudniejsze, w dużej mierze dlatego, że wysłanie zwykle będzie co najmniej częściowo ukończone (informacje o tagu, rozmiarze i źródle są zwykle wysyłane natychmiast do miejsca docelowego). Zaleca się, aby anulowanie wysyłania, podczas gdy operacja lokalna (zgodnie ze standardem MPI) prawdopodobnie będzie kosztowna (zwykle generuje co najmniej jeden komunikat wewnętrzny).
Wymagania
Produkt |
Pakiet redystrybucyjny PROGRAMU HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny PAKIETU HPC Pack 2008 MS-MPI lub narzędzia klienckie PAKIETU HPC Pack 2008 |
Nagłówek |
Mpi.h; Mpif.h |
Biblioteka |
Msmpi.lib |
DLL |
Msmpi.dll |