funktionen MPI_Init_thread
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 |