Partager via


MPI_Waitany fonction

Effectue l’une des opérations en suspens.

Syntaxe

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

Paramètres

  • count
    Nombre d’entrées dans le paramètre array_of_requests .

  • array_of_requests
    Tableau de MPI_Request de handles d’opérations en attente.

  • index [out]
    Pointeur vers un entier qui indique l’index dans le paramètre array_of_requests de l’opération terminée. Le tableau est indexé à partir de zéro en C et d’un dans Fortran.

  • status [out]
    Pointeur vers un objet MPI_Status qui décrit l’opération terminée.

Valeur retournée

Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.

Dans Fortran, la valeur de retour est stockée dans le paramètre IERROR .

Fortran

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

Remarques

Cette fonction est une opération non locale. La réussite de l’exécution peut dépendre des opérations de correspondance sur d’autres processus.

Cette fonction retourne quand l’une des opérations associées aux requêtes actives dans le paramètre array_of_requests est terminée. Si plusieurs opérations en suspens sont terminées, une opération est choisie arbitrairement. Si l’opération terminée est une opération de communication persistante, la demande persistante est marquée comme inactive. Une opération non persistante est libérée et son entrée correspondante dans le paramètre array_of_requests est définie sur MPI_REQUEST_NULL.

Les entrées du paramètre array_of_requests peuvent être MPI_REQUEST_NULL ou un handle pour une demande de communication permanente inactive. Si le paramètre count est égal à zéro ou si toutes les entrées de array_of_requests sont des demandes de communication persistantes MPI_REQUEST_NULL ou inactives, la fonction retourne immédiatement avec le paramètre d’index défini sur MPI_UNDEFINED et un status vide.

Configuration requise

Produit

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

En-tête

Mpi.h ; Mpif.h

Bibliothèque

Msmpi.lib

DLL

Msmpi.dll

Voir aussi

Fonctions point à point MPI

MPI_Testany

MPI_Wait

MPI_Waitall

MPI_Waitsome

MPI_Status