funktionen MPI_Waitany

Artikel
11/27/2023

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

Syntax

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

Parametrar

Räkna
Antalet poster i parametern array_of_requests .
array_of_requests
En matris med MPI_Request hanterar utestående åtgärder.
index [out]
En pekare till ett heltal som anger indexet i parametern array_of_requests för åtgärden som har slutförts. Matrisen indexeras från noll i C och från en i Fortran.
status [out]
En pekare till ett MPI_Status objekt som beskriver den slutförda åtgärden.

Returvärde

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

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_WAITANY(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. Lyckat slutförande kan bero på matchande åtgärder i andra processer.

Den här funktionen returneras när en av de åtgärder som är associerade med aktiva begäranden i array_of_requests parametern har slutförts. Om mer än en utestående åtgärd har slutförts väljs en godtyckligt. Om den slutförda åtgärden är en beständig kommunikationsåtgärd markeras den beständiga begäran som inaktiv. En icke-beständig åtgärd frigörs och motsvarande post i parametern array_of_requests anges till MPI_REQUEST_NULL.

Poster i parametern array_of_requests kan vara MPI_REQUEST_NULL eller en referens till 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