MPI_Waitsome, funkcja
Wykonuje niektóre z kilku wybitnych operacji.
Składnia
int MPIAPI MPI_Waitsome(
int incount,
_Inout_count_(incount) MPI_Request array_of_requests,
_Out_ int *outcount,
_Out_cap_post_count_(incount,*outcount) int *array_of_indices,
_Out_cap_post_count_(incount,*outcount) *array_of_statuses
);
Parametry
incount
Liczba wpisów w parametrze array_of_requests .array_of_requests
Tablica MPI_Request obsługuje zaległe operacje.outcount [out]
Liczba ukończonych żądań.array_of_indices
Tablica indeksów w array_of_requests wykonanych operacji. Array_of_requests jest indeksowany od zera w C, a z jednego w Fortran.array_of_statuses
Tablica obiektów stanu dla operacji zakończonych lub MPI_STATUSES_IGNORE.
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_WAITSOME(INCOUNT, ARRAY_OF_REQUESTS, OUTCOUNT, ARRAY_OF_INDICES, ARRAY_OF_STATUSES, IERROR)
INTEGER INCOUNT, ARRAY_OF_REQUESTS(*), OUTCOUNT, ARRAY_OF_INDICES(*),
ARRAY_OF_STATUSES(MPI_STATUS_SIZE,*), IERROR
Uwagi
Tablica wskaźników jest w zakresie od 0 do liczby - 1 dla C i w zakresie 1do liczenia dla Fortran.
Żądania o wartości NULL są ignorowane; jeśli wszystkie żądania mają wartość NULL, procedura zwraca wartość z wartością outcount ustawioną na MPI_UNDEFINED.
Chociaż istnieje możliwość wyświetlenia listy dojścia żądania więcej niż raz w array_of_requests, taka akcja jest uznawana za błędną i może spowodować, że program nieskonfikuje działanie lub generuje nieprawidłowe wyniki.
MPI_Waitsome zapewnia interfejs podobny do wywołań "select" lub "poll" systemu Unix, a w implementacji o wysokiej nierówności wskazuje wszystkie żądania, które zostały ukończone po wywołaniu MPI_Waitsome . Jednak MPI_Waitsome gwarantuje, że co najmniej jedno żądanie zostało zakończone; nie ma gwarancji, że zostaną zwrócone wszystkie ukończone żądania lub że wpisy w array_of_indices będą w kolejności rosnącej. Ponadto żądania zakończone podczas wykonywania MPI_Waitsome mogą być zwracane lub nie mogą być zwracane, w zależności od czasu zakończenia komunikatu.
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 |