MPI_Waitany, funkcja
Kończy jedną z kilku wybitnych operacji.
Składnia
int MPIAPI MPI_Waitany(
int count,
_Inout_count_(count) MPI_Request *array_of_requests,
_Out_ int *index,
_Out_ MPI_Status *status
);
Parametry
Liczba
Liczba wpisów w parametrze array_of_requests .array_of_requests
Tablica MPI_Request obsługuje zaległe operacje.index [out]
Wskaźnik do liczby całkowitej wskazujący indeks w parametrze array_of_requests operacji, która została ukończona. Tablica jest indeksowana z zera w języku C i z jednej w Fortran.status [out]
Wskaźnik do obiektu MPI_Status opisującego ukończoną operację.
Wartość zwracana
Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.
W fortran wartość zwracana jest przechowywana w parametrze IERROR .
Fortran
MPI_WAITANY(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.
Ta funkcja jest zwracana, gdy zostanie ukończona jedna z operacji skojarzonych z aktywnymi żądaniami w parametrze array_of_requests . Jeśli ukończono więcej niż jedną zaległą operację, zostanie wybrana dowolnie. Jeśli ukończona operacja jest trwałą operacją komunikacji, żądanie trwałe jest oznaczone jako nieaktywne. Operacja nonpersistent jest cofana, a jej odpowiedni wpis w parametrze array_of_requests jest ustawiony 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 |