funktionen MPI_Test

2023-05-24

Testar en utestående åtgärd för slutförande.

Syntax

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

Parametrar

request [in, out]
En pekare till MPI_Request handtag för en utestående åtgärd.
flagga [ut]
Vid retur innehåller en pekare till ett heltal som anger om begäran har slutförts. Ett värde som inte är noll anger att begäran har slutförts.
status [out]
Vid retur innehåller en pekare till ett MPI_Status objekt som beskriver den angivna åtgärden om den är klar.

Returvärde

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

I Fortran lagras returvärdet i parametern IERROR .

Fortran

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

Kommentarer

Den här funktionen är en lokal åtgärd. Lyckat slutförande är inte beroende av några åtgärder i andra processer.

Om åtgärden som är associerad med den här begäran var en beständig kommunikationsåtgärd markeras den beständiga begäran som inaktiv. Andra åtgärder frigörs och begärandereferensen är inställd på MPI_REQUEST_NULL.

Om parametern för begäran pekar på värdet MPI_REQUEST_NULL eller en inaktiv beständig begäran returneras funktionen med parametern flag inställd på ett värde som inte är noll och med statusparametern tom.

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