funktionen MPI_Waitsome
Slutför några av flera utestående åtgärder.
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
);
Parametrar
incount
Antalet poster i parametern array_of_requests .array_of_requests
En matris med MPI_Request hanterar utestående åtgärder.outcount [out]
Antalet slutförda begäranden.array_of_indices
Matris med index i array_of_requests av åtgärder som slutfördes. Array_of_requests indexeras från noll i C och från en i Fortran.array_of_statuses
Matris med statusobjekt för åtgärder som har slutförts eller MPI_STATUSES_IGNORE.
Returvärde
Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.
I Fortran lagras returvärdet i parametern 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
Kommentarer
Matrisen med dikter ligger i intervallet 0 till incount – 1 för C och i intervallet 1 till incount för Fortran.
NULL-begäranden ignoreras. Om alla begäranden är NULL returneras rutinen med outcount inställt på MPI_UNDEFINED.
Även om det är möjligt att lista en begäran handtag mer än en gång i array_of_requests, anses en sådan åtgärd felaktig och kan orsaka programmet att unexectedly avsluta eller ge felaktiga resultat.
MPI_Waitsome tillhandahåller ett gränssnitt som liknar unix-anropen "select" eller "poll" och i en implementering med hög kvalitet anger alla begäranden som har slutförts när MPI_Waitsome anropas. Men MPI_Waitsome garanterar endast att minst en begäran har slutförts. Det finns ingen garanti för att alla slutförda begäranden kommer att returneras eller att posterna i array_of_indices kommer att vara i ökande ordning. Begäranden som slutförs när MPI_Waitsome körs kan också returneras, beroende på tidpunkten för meddelandets slutförande.
Krav
Produkt |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities |
Huvud |
Mpi.h; Mpif.h |
Bibliotek |
Msmpi.lib |
DLL |
Msmpi.dll |