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

Zobacz też

Funkcje zewnętrzne MPI

MPI_Finalize

MPI_Init