Sdílet prostřednictvím


MPI_Waitany funkce

Dokončí jednu z několika nevyřízených operací.

Syntaxe

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

Parametry

  • Počet
    Počet položek v parametru array_of_requests .

  • array_of_requests
    Pole MPI_Request zpracování nevyřízených operací.

  • index [out]
    Ukazatel na celé číslo, které označuje index v parametru array_of_requests dokončené operace. Pole je indexováno z nuly v jazyce C a z jedné ve Fortranu.

  • status [out]
    Ukazatel na objekt MPI_Status , který popisuje dokončenou operaci.

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

V nástroji Fortran je vrácená hodnota uložena v parametru IERROR .

Fortran

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

Poznámky

Tato funkce je jiná než místní operace. Úspěšné dokončení může záviset na odpovídajících operacích v jiných procesech.

Tato funkce se vrátí, když je dokončena jedna z operací přidružených k aktivním požadavkům v parametru array_of_requests . Pokud se dokončí více než jedna nevyrovnaná operace, vybere se libovolně jedna. Pokud je dokončená operace trvalou komunikací, trvalý požadavek se označí jako neaktivní. Operace nepersistent je uvolněna a její odpovídající položka v parametru array_of_requests je nastavena na MPI_REQUEST_NULL.

Položky v parametru array_of_requests mohou být MPI_REQUEST_NULL nebo popisovač pro neaktivní trvalý požadavek na komunikaci. Pokud je parametr count nula nebo jsou všechny položky v array_of_requestsMPI_REQUEST_NULL nebo neaktivní požadavky na trvalou komunikaci, vrátí funkce okamžitě s parametrem indexu nastaveným na MPI_UNDEFINED a prázdným stavem.

Požadavky

Produkt

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package nebo HPC Pack 2008 Client Utilities

Hlavička

Mpi.h; Mpif.h

Knihovna

Msmpi.lib

DLL

Msmpi.dll

Viz také

Funkce MPI typu point-to-point

MPI_Testany

MPI_Wait

MPI_Waitall

MPI_Waitsome

MPI_Status