Delen via


MPI_Test functie

Test een openstaande bewerking voor voltooiing.

Syntaxis

int MPIAPI MPI_Test(
  _Inout_  MPI_Request *request,
  _Out_   int          *flag,
  _Out_   MPI_Status   *status
);

Parameters

  • aanvraag [in, uit]
    Een aanwijzer naar de MPI_Request handgreep van een openstaande bewerking.

  • vlag [uit]
    Bij retour bevat een aanwijzer naar een geheel getal dat aangeeft of de aanvraag is voltooid. Een niet-nulwaarde geeft aan dat de aanvraag is voltooid.

  • status [uit]
    Bij retour bevat een aanwijzer naar een MPI_Status-object dat de opgegeven bewerking beschrijft als deze is voltooid.

Retourwaarde

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

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

    MPI_WAIT(REQUEST, FLAG, STATUS, IERROR)
        LOGICAL FLAG
        INTEGER REQUEST, STATUS(MPI_STATUS_SIZE), IERROR

Opmerkingen

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

Als de bewerking die aan deze aanvraag is gekoppeld, een permanente communicatiebewerking is, wordt de permanente aanvraag gemarkeerd als inactief. De toewijzing van andere bewerkingen wordt ongedaan gemaakt en de aanvraagingang is ingesteld op MPI_REQUEST_NULL.

Als de aanvraagparameter verwijst naar een waarde van MPI_REQUEST_NULL of naar een inactieve permanente aanvraag, retourneert de functie met de vlagparameter ingesteld op een niet-nulwaarde en met de statusparameter leeg.

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_Wait

MPI_Status

MPI_Testany

MPI_Testall

MPI_Testsome