Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
MPI_Grequest_query_function az alkalmazás által definiált függvénynév helyőrzője.
Szintaxis
int MPI_Grequest_query_function(
_In_opt_ void *extra_state,
_Out_ MPI_Status *status
);
Paraméterek
extra_state [in, nem kötelező]
Extra állapot.status [out]
MPI-állapotobjektum.
Visszatérési érték
Minden visszahívási függvény hibakódot ad vissza. A visszahívási függvényt meghívó MPI-függvény visszaadja a kódot, és a hibakódnak megfelelően kezeli. Ha például hibakódokat ad vissza, akkor a visszahívási függvény által visszaadott hibakódot a visszahívási függvényt meghívó MPI-függvény adja vissza. MPI_{Wait|Tesztelje} minden olyan hívást, amely query_fn és free_fn is meghív, az MPI-hívás az utolsó visszahívás által visszaadott hibakódot adja vissza, nevezetesen free_fn. Ha egy vagy több kérés MPI_ {Wait| hívásbanTest}{some|all} sikertelen volt, majd az MPI-hívás MPI_ERR_IN_STATUS fog visszaadni. Ilyen esetben, ha az MPI-hívást állapotok tömbje adta át, akkor az MPI a befejezett általános kérésnek megfelelő állapotokban visszaadja a free_fn visszahívási függvény megfelelő meghívása által visszaadott hibakódot. Ha azonban az MPI-függvény MPI_STATUSES_IGNORE lett átadva, akkor az egyes visszahívási függvények által visszaadott egyedi hibakódok elvesznek.
Fortran
SUBROUTINE GREQUEST_QUERY_FUNCTION(EXTRA_STATE, STATUS, IERROR)
INTEGER STATUS(MPI_STATUS_SIZE), IERROR
INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE
Megjegyzések
A query_fn függvény kiszámítja az általános kéréshez visszaadandó állapotot. Az állapot a kérelem sikeres/sikertelen törlésére vonatkozó információkat is tartalmaz (az eredményt MPI_Test_cancelled adja vissza).
A query_fn visszahívást a(z) {Wait| MPI_ hívja megTest}{any|some|all} hívás, amely teljesítette a visszahíváshoz társított általános kérést. A visszahívási függvényt a MPI_Request_get_status hívása is meghívja, ha a kérés befejeződött a hívás során. A visszahívás mindkét esetben egy hivatkozást ad át a felhasználó által az MPI-hívásnak átadott megfelelő állapotváltozóra; a visszahívási függvény által beállított állapotot az MPI-hívás adja vissza. Ha a felhasználó MPI_STATUS_IGNORE vagy MPI_STATUSES_IGNORE adott meg az MPI-függvénynek, amely query_fn meghívását okozza, akkor az MPI érvényes állapotobjektumot ad át query_fn, és ezt az állapotot a visszahívási függvény visszatérésekor figyelmen kívül hagyja. Vegye figyelembe, hogy a query_fn csak akkor lesz meghívva , ha MPI_Grequest_complete a kérelemben; többször is meghívható ugyanahhoz az általános kéréshez, például ha a felhasználó többször is meghívja MPI_Request_get_status a kéréshez. Vegye figyelembe azt is, hogy a (z) MPI_{Wait| hívásaTest}{some|all} több híváshívást okozhat query_fn visszahívási függvényekhez, amelyek mindegyike az MPI-hívás által befejezett általánosított kérésekhez tartozik. A meghívások sorrendjét az MPI nem határozza meg.
Követelmények
Termék |
HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI újraterjeszthető csomag vagy HPC Pack 2008 ügyfél-segédprogramok |
Fejléc |
Mpi.h; Mpif.h |