MPI_Waitall, funkcja
Wykonuje wiele zaległych operacji.
Składnia
int MPIAPI MPI_Waitall(
int count,
_Inout_count_(count) MPI_Request *array_of_requests,
_Out_cap_(count) MPI_Status *array_of_statuses
);
Parametry
Liczba
Liczba wpisów w parametrze array_of_requests .array_of_requests
Tablica MPI_Request obsługuje zaległe operacje.array_of_statuses
Tablica obiektów MPI_Status opisujących ukończone operacje. Może to być MPI_STATUSES_IGNORE , jeśli nie są wymagane żadne informacje o stanie.
Wartość zwracana
Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.
Zwraca MPI_ERR_IN_STATUS , jeśli co najmniej jedna operacja zostanie ukończona w błędzie. Stan operacji, które zakończyły się niepowodzeniem, jest zwracany w odpowiednim wpisie w parametrze array_of_statuses .
W fortran zwracana wartość jest przechowywana w parametrze IERROR .
Fortran
MPI_WAITALL(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR
Uwagi
Ta funkcja jest operacją nielokacyjną, pomyślne ukończenie może zależeć od pasujących operacji w innych procesach.
Wywołanie MPI_Waitall zwraca, gdy wszystkie operacje skojarzone z aktywnymi żądaniami w tablicy array_of_requests zostaną ukończone. Wszystkie wpisy skojarzone z trwałymi operacjami komunikacji powodują, że żądanie trwałe jest oznaczone jako nieaktywne. Inne operacje są cofane, a odpowiednie wpisy w array_of_requests są ustawione na MPI_REQUEST_NULL.
Wpisy w parametrze array_of_requests mogą być MPI_REQUEST_NULL lub dojścia do nieaktywnego trwałego żądania komunikacji. Jeśli parametr count ma wartość zero lub wszystkie wpisy w array_of_requests są MPI_REQUEST_NULL lub nieaktywne żądania trwałej komunikacji, funkcja zwraca natychmiast z parametrem indeksu ustawionym na MPI_UNDEFINED i pusty stan.
Wymagania
Produkt |
Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008 |
Nagłówek |
Mpi.h; Mpif.h |
Biblioteka |
Msmpi.lib |
DLL |
Msmpi.dll |