MPI_Init_thread functie

Initialiseert de uitvoeringsomgeving van het aanroepende MPI-proces voor uitvoering met threads.

Syntaxis

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

Parameters

• argc [in, optioneel]
  Een verwijzing naar het aantal argumenten voor het programma. Deze waarde kan NULL zijn.

• argv [optioneel]
  Een verwijzing naar de argumentenlijst voor het programma. Deze waarde kan NULL zijn.

• vereist [in]
  Het niveau van de gewenste threadondersteuning. Meerdere MPI-processen in dezelfde taak kunnen verschillende waarden gebruiken.

  MPI_THREAD_SINGLE	Er wordt slechts één thread in het programma uitgevoerd.
  MPI_THREAD_FUNNELED	Het proces kan meerdere threads bevatten, maar de thread die MPI_Init_thread heeft aangeroepen, is de enige die MPI-functie-aanroepen doet.
  MPI_THREAD_SERIALIZED	Het proces kan meerdere threads bevatten en al deze threads kunnen MPI-functieaanroepen maken, maar slechts één voor één.
  MPI_THREAD_MULTIPLE	Meerdere toepassingsthreads kunnen MPI-functies aanroepen zonder beperkingen. Deze waarde wordt momenteel alleen ondersteund op MS-MPI V6 op Windows Server 2012, Windows Server 2012 R2, Windows 8 en Windows 8.1.

   

• provided [out]
  Het niveau van de opgegeven threadondersteuning. De geretourneerde waarde komt uit de bovenstaande tabel.

   

Retourwaarde

MPI_SUCCESS of de functie wordt geretourneerd. Andere foutcodes als de aanroep om andere redenen (zoals ongeldige argumenten) is mislukt.

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

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

Opmerkingen

Deze functie mag slechts door één thread worden aangeroepen. Deze thread wordt de 'hoofdthread' genoemd en moet dezelfde thread zijn om MPI_Finalize aan te roepen.

De Fortran-binding van MPI_Init_thread accepteert de PARAMETERS ARGC en ARGV niet.

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

Externe MPI-functies

MPI_Finalize

MPI_Init