MPI_Init_thread, funkcja
Inicjuje środowisko wykonywania procesu MPI wywołującego na potrzeby wykonywania wątkowego.
Składnia
int MPIAPI MPI_Init_thread(
_In_opt_ int *argc,
_In_opt_count_(*argc) char ***argv,
_In_ int required,
_Out_ int *provided
);
Parametry
argc [in, opcjonalnie]
Wskaźnik do liczby argumentów programu. Ta wartość może mieć wartość NULL.argv [opcjonalnie]
Wskaźnik do listy argumentów programu. Ta wartość może mieć wartość NULL.wymagane [in]
Poziom obsługi żądanego wątku. Wiele procesów MPI w tym samym zadaniu może używać różnych wartości.MPI_THREAD_SINGLE Zostanie wykonany tylko jeden wątek w programie. MPI_THREAD_FUNNELED Proces może zawierać wiele wątków, ale wątek o nazwie MPI_Init_thread jest jedynym, który wykonuje wywołania funkcji MPI. MPI_THREAD_SERIALIZED Proces może zawierać wiele wątków, a wszystkie te wątki mogą wykonywać wywołania funkcji MPI, ale tylko jeden naraz. MPI_THREAD_MULTIPLE Wiele wątków aplikacji może wywoływać funkcje MPI bez ograniczeń. Ta wartość jest obecnie obsługiwana tylko w programie MS-MPI V6 działającym w Windows Server 2012, Windows Server 2012 R2, Windows 8 i Windows 8.1. dostarczone [out]
Poziom zapewnianej obsługi wątków. Zwrócona wartość będzie pochodzić z powyższej tabeli.
Wartość zwracana
MPI_SUCCESS , jeśli funkcja zostanie zwrócona pomyślnie. Inne kody błędów, jeśli wywołanie nie powiodło się z innych powodów (takich jak nieprawidłowe argumenty).
W fortran zwracana wartość jest przechowywana w parametrze IERROR .
Fortran
MPI_INIT_THREAD(REQUIRED, PROVIDED, IERROR)
INTEGER REQUIRED, PROVIDED, IERROR
Uwagi
Ta funkcja musi być wywoływana tylko przez jeden wątek. Ten wątek będzie znany jako "Główny wątek" i musi być tym samym wątkiem, aby wywołać MPI_Finalize.
Powiązanie Fortran MPI_Init_thread nie akceptuje parametrów ARGC i ARGV.
Wymagania
Produkt |
Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008 |
Nagłówek |
Mpi.h; Mpif.h |
Biblioteka |
Msmpi.lib |
DLL |
Msmpi.dll |