Delen via


MPI_Waitany functie

Voltooit een van de verschillende openstaande bewerkingen.

Syntaxis

int MPIAPI MPI_Waitany(
        int                              count,
        _Inout_count_(count) MPI_Request *array_of_requests,
  _Out_ int                              *index,
  _Out_ MPI_Status                       *status
);

Parameters

  • Tellen
    Het aantal vermeldingen in de parameter array_of_requests .

  • array_of_requests
    Een matrix met MPI_Request ingangen van openstaande bewerkingen.

  • index [uit]
    Een aanwijzer naar een geheel getal dat de index aangeeft in de array_of_requests parameter van de bewerking die is voltooid. De matrix wordt geïndexeerd van nul in C en van één in Fortran.

  • status [uit]
    Een aanwijzer naar een MPI_Status-object dat de voltooide bewerking beschrijft.

Retourwaarde

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

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

    MPI_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
        INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR

Opmerkingen

Deze functie is een niet-lokale bewerking. Een geslaagde voltooiing kan afhankelijk zijn van overeenkomende bewerkingen in andere processen.

Deze functie retourneert wanneer een van de bewerkingen die zijn gekoppeld aan actieve aanvragen in de parameter array_of_requests is voltooid. Als er meer dan één openstaande bewerking is voltooid, wordt er willekeurig een gekozen. Als de voltooide bewerking een permanente communicatiebewerking is, wordt de permanente aanvraag gemarkeerd als inactief. De toewijzing van een niet-persistente bewerking wordt ongedaan gemaakt en de bijbehorende vermelding in de parameter array_of_requests wordt ingesteld op MPI_REQUEST_NULL.

Vermeldingen in de parameter array_of_requests kunnen worden MPI_REQUEST_NULL of een ingang voor een inactieve permanente communicatieaanvraag. Als de parameter count nul is of als alle vermeldingen in array_of_requestsMPI_REQUEST_NULL of inactieve permanente communicatieaanvragen zijn, wordt de functie onmiddellijk geretourneerd met de indexparameteringesteld op MPI_UNDEFINED en een lege status.

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

MPI_Testany

MPI_Wait

MPI_Waitall

MPI_Waitsome

MPI_Status