Dela via

funktionen MPI_Init_thread

  • Artikel

Initierar den anropande MPI-processens körningsmiljö för trådad körning.

Syntax

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

Parametrar

  • argc [in, optional]
    En pekare till antalet argument för programmet. Det här värdet kan vara NULL.

  • argv [valfritt]
    En pekare till argumentlistan för programmet. Det här värdet kan vara NULL.

  • krävs [in]
    Nivån för önskat trådstöd. Flera MPI-processer i samma jobb kan använda olika värden.

    MPI_THREAD_SINGLE Endast en tråd i programmet körs.
    MPI_THREAD_FUNNELED Processen kan innehålla flera trådar, men tråden som anropade MPI_Init_thread är den enda som gör MPI-funktionsanrop.
    MPI_THREAD_SERIALIZED Processen kan innehålla flera trådar och alla dessa trådar kan göra MPI-funktionsanrop, men bara en i taget.
    MPI_THREAD_MULTIPLE Flera programtrådar kan anropa MPI-funktioner utan begränsningar. Det här värdet stöds för närvarande endast på MS-MPI V6 som körs på Windows Server 2012, Windows Server 2012 R2, Windows 8 och Windows 8.1.

     

  • tillhandahålls [ut]
    Nivån på det tillhandahållna trådstödet. Värdet som returneras kommer från tabellen ovan.

     

Returvärde

MPI_SUCCESS om funktionen returnerar korrekt. Andra felkoder om anropet misslyckades av andra orsaker (till exempel ogiltiga argument).

I Fortran lagras returvärdet i parametern IERROR .

Fortran

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

Kommentarer

Den här funktionen måste bara anropas av en tråd. Tråden kallas för "huvudtråden" och måste vara samma tråd för att anropa MPI_Finalize.

Fortran-bindningen för MPI_Init_thread accepterar inte ARGC- och ARGV-parametrarna.

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

Se även

Externa MPI-funktioner

MPI_Finalize

MPI_Init