MPI_Waitsome-Funktion
Schließt einige der ausstehenden Vorgänge ab.
Syntax
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
);
Parameter
incount
Die Anzahl der Einträge im parameter array_of_requests .array_of_requests
Ein Array von MPI_Request Handles ausstehender Vorgänge.outcount [out]
Die Anzahl der abgeschlossenen Anforderungen.array_of_indices
Array von Indizes im array_of_requests abgeschlossener Vorgänge. Die array_of_requests wird von null in C und von 1 in Fortran indiziert.array_of_statuses
Array von status-Objekten für abgeschlossene Vorgänge oder MPI_STATUSES_IGNORE.
Rückgabewert
Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.
In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.
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
Hinweise
Das Array von Dicies liegt im Bereich von 0 bis incount - 1 für C und im Bereich 1 bis incount für Fortran.
NULL-Anforderungen werden ignoriert. Wenn alle Anforderungen NULL sind, gibt die Routine zurück, wobei outcount auf MPI_UNDEFINED festgelegt ist.
Obwohl es möglich ist, ein Anforderungshandle mehrmals im array_of_requests auflisten, wird eine solche Aktion als fehlerhaft angesehen und kann dazu führen, dass das Programm nicht ausgeführt wird oder zu falschen Ergebnissen führt.
MPI_Waitsome stellt eine Schnittstelle bereit, die den Unix-Aufrufen "select" oder "poll" ähnelt, und gibt in einer Implementierung mit hoher Qualität alle Anforderungen an, die beim Aufruf von MPI_Waitsome abgeschlossen wurden. MPI_Waitsome garantiert jedoch nur, dass mindestens eine Anforderung abgeschlossen wurde; es gibt keine Garantie dafür, dass alle abgeschlossenen Anforderungen zurückgegeben werden oder dass die Einträge in array_of_indices in zunehmender Reihenfolge ausgeführt werden. Außerdem können Anforderungen, die abgeschlossen werden, während MPI_Waitsome ausgeführt wird, je nach Zeitpunkt des Abschlusses der Nachricht zurückgegeben werden.
Anforderungen
Produkt |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliothek |
Msmpi.lib |
DLL |
Msmpi.dll |