funktionen MPI_Waitall

Artikel
08/14/2023

Slutför flera utestående åtgärder.

Syntax

int MPIAPI MPI_Waitall(
   int                              count,
   _Inout_count_(count) MPI_Request *array_of_requests,
   _Out_cap_(count) MPI_Status      *array_of_statuses
);

Parametrar

Räkna
Antalet poster i parametern array_of_requests .
array_of_requests
En matris med MPI_Request hanterar utestående åtgärder.
array_of_statuses
En matris med MPI_Status objekt som beskriver slutförda åtgärder. Det kan vara MPI_STATUSES_IGNORE om ingen statusinformation begärs.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

Returnerar MPI_ERR_IN_STATUS om en eller flera åtgärder har slutförts av misstag. Statusen för misslyckade åtgärder returneras i motsvarande post i parametern array_of_statuses .

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_WAITALL(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, och slutförandet kan bero på matchande åtgärder i andra processer.

Ett anrop till MPI_Waitall returneras när alla åtgärder som är associerade med aktiva begäranden i array_of_requests matrisen har slutförts. Alla poster som är associerade med beständiga kommunikationsåtgärder resulterar i att den beständiga begäran markeras som inaktiv. Andra åtgärder frigörs och motsvarande poster i array_of_requests anges till MPI_REQUEST_NULL.

Poster i parametern array_of_requests kan vara MPI_REQUEST_NULL eller ett handtag för 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