MPI_Test-Funktion
Testet einen hervorragenden Vorgang auf Abschluss.
Syntax
int MPIAPI MPI_Test(
_Inout_ MPI_Request *request,
_Out_ int *flag,
_Out_ MPI_Status *status
);
Parameter
Anforderung [ein, aus]
Ein Zeiger auf den MPI_Request Handle eines ausstehenden Vorgangs.flag [out]
Enthält beim Zurückgeben einen Zeiger auf eine ganze Zahl, die angibt, ob die Anforderung abgeschlossen ist. Ein Wert ungleich 0 gibt an, dass die Anforderung abgeschlossen ist.status [out]
Enthält bei der Rückgabe einen Zeiger auf ein MPI_Status-Objekt , das den angegebenen Vorgang beschreibt, wenn er abgeschlossen ist.
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_WAIT(REQUEST, FLAG, STATUS, IERROR)
LOGICAL FLAG
INTEGER REQUEST, STATUS(MPI_STATUS_SIZE), IERROR
Hinweise
Diese Funktion ist ein lokaler Vorgang. Der erfolgreiche Abschluss hängt nicht von Vorgängen bei anderen Prozessen ab.
Wenn der dieser Anforderung zugeordnete Vorgang ein persistenter Kommunikationsvorgang war, wird die persistente Anforderung als inaktiv markiert. Andere Vorgänge werden zugeordnet, und das Anforderungshandle ist auf MPI_REQUEST_NULL festgelegt.
Wenn der Anforderungsparameter auf einen Wert von MPI_REQUEST_NULL oder auf eine inaktive persistente Anforderung verweist, gibt die Funktion zurück, wobei der Flagparameter auf einen Wert ungleich null festgelegt ist und der status Parameter leer ist.
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 |