funktionen MPI_Waitany
Slutför en av flera utestående åtgärder.
Syntax
int MPIAPI MPI_Waitany(
int count,
_Inout_count_(count) MPI_Request *array_of_requests,
_Out_ int *index,
_Out_ MPI_Status *status
);
Parametrar
Räkna
Antalet poster i parametern array_of_requests .array_of_requests
En matris med MPI_Request hanterar utestående åtgärder.index [out]
En pekare till ett heltal som anger indexet i parametern array_of_requests för åtgärden som har slutförts. Matrisen indexeras från noll i C och från en i Fortran.status [out]
En pekare till ett MPI_Status objekt som beskriver den slutförda åtgärden.
Returvärde
Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.
I Fortran lagras returvärdet i parametern IERROR .
Fortran
MPI_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR
Kommentarer
Den här funktionen är en icke-lokal åtgärd. Lyckat slutförande kan bero på matchande åtgärder i andra processer.
Den här funktionen returneras när en av de åtgärder som är associerade med aktiva begäranden i array_of_requests parametern har slutförts. Om mer än en utestående åtgärd har slutförts väljs en godtyckligt. Om den slutförda åtgärden är en beständig kommunikationsåtgärd markeras den beständiga begäran som inaktiv. En icke-beständig åtgärd frigörs och motsvarande post i parametern array_of_requests anges till MPI_REQUEST_NULL.
Poster i parametern array_of_requests kan vara MPI_REQUEST_NULL eller en referens till en inaktiv beständig kommunikationsbegäran. Om parametern count är noll, eller om alla poster i array_of_requests är MPI_REQUEST_NULL eller inaktiva beständiga kommunikationsbegäranden, returnerar funktionen omedelbart med indexparametern inställd på MPI_UNDEFINED och en tom status.
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 |