MPI_Waitsome functie

Voltooit een aantal van de verschillende openstaande bewerkingen.

Syntaxis

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
);

Parameters

• incount
  Het aantal vermeldingen in de parameter array_of_requests .

• array_of_requests
  Een matrix met MPI_Request ingangen van openstaande bewerkingen.

• outcount [out]
  Het aantal voltooide aanvragen.

• array_of_indices
  Matrix van indexen in de array_of_requests van bewerkingen die zijn voltooid. De array_of_requests wordt geïndexeerd van nul in C en van één in Fortran.

• array_of_statuses
  Matrix van statusobjecten voor bewerkingen die zijn voltooid of MPI_STATUSES_IGNORE.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter 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

Opmerkingen

De matrix met indicies bevindt zich in het bereik van 0 tot incount - 1 voor C en in het bereik 1 tot incount voor Fortran.

NULL-aanvragen worden genegeerd; als alle aanvragen NULL zijn, wordt de routine geretourneerd met het aantal dat is ingesteld op MPI_UNDEFINED.

Hoewel het mogelijk is om een aanvraagingsing meer dan één keer in de array_of_requests weer te geven, wordt een dergelijke actie als onjuist beschouwd en kan het programma onverwacht worden beëindigd of onjuiste resultaten produceren.

MPI_Waitsome biedt een interface die vergelijkbaar is met de Unix-aanroepen voor selecteren of peilen en geeft in een implementatie met hoge kwaliteit alle aanvragen aan die zijn voltooid wanneer MPI_Waitsome wordt aangeroepen. MPI_Waitsome garandeert echter alleen dat ten minste één aanvraag is voltooid; er is geen garantie dat alle voltooide aanvragen worden geretourneerd of dat de vermeldingen in array_of_indices in oplopende volgorde staan. Aanvragen die zijn voltooid terwijl MPI_Waitsome wordt uitgevoerd, kunnen al dan niet worden geretourneerd, afhankelijk van de timing van de voltooiing van het bericht.

Vereisten

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliotheek	Msmpi.lib
DLL	Msmpi.dll

Zie ook

MPI-punt-naar-puntfuncties