MPI_Init_thread függvény

Inicializálja a hívó MPI-folyamat végrehajtási környezetét a szálkezeléses végrehajtáshoz.

Szintaxis

int MPIAPI MPI_Init_thread(
  _In_opt_ int                        *argc,
           _In_opt_count_(*argc) char ***argv,
  _In_     int                        required,
  _Out_    int                        *provided
);

Paraméterek

• argc [in, nem kötelező]
  Mutató a program argumentumainak számára. Ez az érték NULL értékű lehet.

• argv [nem kötelező]
  A program argumentumlistájára mutató mutató. Ez az érték NULL értékű lehet.

• kötelező [in]
  A kívánt száltámogatás szintje. Az ugyanabban a feladatban lévő több MPI-folyamat eltérő értékeket használhat.

  MPI_THREAD_SINGLE	A program csak egyetlen szálat hajt végre.
  MPI_THREAD_FUNNELED	A folyamat több szálat is tartalmazhat, de a MPI_Init_thread nevű szál az egyetlen, amely MPI-függvényhívásokat kezdeményez.
  MPI_THREAD_SERIALIZED	A folyamat több szálat is tartalmazhat, és az összes szál MPI-függvényhívásokat kezdeményezhet, de egyszerre csak egyet.
  MPI_THREAD_MULTIPLE	Több alkalmazásszál is meghívhat korlátozás nélküli MPI-függvényeket. Ez az érték jelenleg csak a Windows Server 2012, Windows Server 2012 R2, Windows 8 és Windows 8.1 rendszeren futó MS-MPI V6 esetén támogatott.

   

• megadva [ki]
  A megadott száltámogatás szintje. A visszaadott érték a fenti táblázatból származik.

   

Visszatérési érték

MPI_SUCCESS , hogy a függvény sikeresen visszatér-e. Egyéb hibakódok, ha a hívás más okból (például érvénytelen argumentumok) miatt meghiúsult.

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

Fortran

    MPI_INIT_THREAD(REQUIRED, PROVIDED, IERROR)
        INTEGER REQUIRED, PROVIDED, IERROR

Megjegyzések

Ezt a függvényt csak egy szál hívható meg. Ezt a szálat főszálnak nevezzük, és ugyanazzal a szálal kell meghívni MPI_Finalize.

A MPI_Init_thread Fortran kötése nem fogadja el az ARGC és az ARGV paramétereket.

Követelmények

Lásd még

MPI külső függvényei

MPI_Finalize

MPI_Init