funzione MPI_Init_thread
Inizializza l'ambiente di esecuzione del processo MPI chiamante per l'esecuzione in thread.
Sintassi
int MPIAPI MPI_Init_thread(
_In_opt_ int *argc,
_In_opt_count_(*argc) char ***argv,
_In_ int required,
_Out_ int *provided
);
Parametri
argc [in, facoltativo]
Puntatore al numero di argomenti per il programma. Questo valore può essere NULL.argv [facoltativo]
Puntatore all'elenco di argomenti per il programma. Questo valore può essere NULL.obbligatorio [in]
Livello di supporto del thread desiderato. Più processi MPI nello stesso processo possono usare valori diversi.MPI_THREAD_SINGLE Verrà eseguito solo un singolo thread nel programma. MPI_THREAD_FUNNELED Il processo può contenere più thread, ma il thread che ha chiamato MPI_Init_thread è l'unico che effettua chiamate di funzione MPI. MPI_THREAD_SERIALIZED Il processo può contenere più thread e tutti questi thread possono effettuare chiamate di funzione MPI, ma solo una alla volta. MPI_THREAD_MULTIPLE Più thread dell'applicazione possono chiamare funzioni MPI senza restrizioni. Questo valore è attualmente supportato solo in MS-MPI V6 in esecuzione in Windows Server 2012, Windows Server 2012 R2, Windows 8 e Windows 8.1. fornito [out]
Livello di supporto del thread fornito. Il valore restituito verrà restituito dalla tabella precedente.
Valore restituito
MPI_SUCCESS se la funzione restituisce correttamente. Altri codici di errore se la chiamata non è riuscita per altri motivi , ad esempio argomenti non validi.
In Fortran il valore restituito viene archiviato nel parametro IERROR .
Fortran
MPI_INIT_THREAD(REQUIRED, PROVIDED, IERROR)
INTEGER REQUIRED, PROVIDED, IERROR
Commenti
Questa funzione deve essere chiamata solo da un thread. Tale thread sarà noto come "Thread principale" e deve essere lo stesso thread da chiamare MPI_Finalize.
L'associazione Fortran di MPI_Init_thread non accetta i parametri ARGC e ARGV.
Requisiti
Prodotto |
Pacchetto ridistribuibile HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Utilità client |
Intestazione |
Mpi.h; Mpif.h |
Libreria |
Msmpi.lib |
DLL |
Msmpi.dll |