funktionen MPI_Waitsome

Artikel
09/28/2023

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

Se även

MPI punkt-till-punkt-funktioner

Dela via