MPI_Cancel függvény

Megszakít egy kommunikációs kérést.

Szintaxis

int MPIAPI MPI_Cancel(
  _In_ MPI_Request *request
);

Paraméterek

• request [in]
  Kommunikációs kérés.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben van tárolva.

Fortran

    MPI_CANCEL(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

Megjegyzések

A MPI_Cancel elsődleges elvárt használata többpufferes sémákban történik, ahol spekulatív MPI_Irecvtörténik. Ha a számítás befejeződött, előfordulhat, hogy a kérések némelyike megmarad; MPI_Cancel lehetővé teszi a felhasználó számára, hogy megszakítsa ezeket a nem megfelelő kéréseket.

A küldési művelet megszakítása sokkal nehezebb, nagyrészt azért, mert a küldés általában legalább részlegesen befejeződik (a címkével, mérettel és forrással kapcsolatos információk általában azonnal a célhelyre kerülnek). A felhasználóknak azt javasoljuk, hogy a küldés megszakítása, míg egy helyi művelet (az MPI szabvány által meghatározottak szerint) költséges lesz (általában egy vagy több belső üzenet generálása).

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
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI pont–pont függvények