MPI_Init_thread işlevi

İş parçacıklı yürütme için çağıran MPI işleminin yürütme ortamını başlatır.

Söz dizimi

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

Parametreler

• argc [in, isteğe bağlı]
  Program için bağımsız değişken sayısını işaret eden bir işaretçi. Bu değer NULL olabilir.

• argv [isteğe bağlı]
  Programın bağımsız değişken listesinin işaretçisi. Bu değer NULL olabilir.

• gerekli [in]
  İstenen iş parçacığı desteği düzeyi. Aynı işteki birden çok MPI işlemi farklı değerler kullanabilir.

  MPI_THREAD_SINGLE	Programda yalnızca tek bir iş parçacığı yürütülür.
  MPI_THREAD_FUNNELED	İşlem birden çok iş parçacığı içerebilir, ancak MPI işlev çağrıları yapan tek iş parçacığı MPI_Init_thread olarak adlandırılır.
  MPI_THREAD_SERIALIZED	İşlem birden çok iş parçacığı içerebilir ve bu iş parçacıklarının tümü MPI işlev çağrıları yapabilir, ancak aynı anda yalnızca bir tane olabilir.
  MPI_THREAD_MULTIPLE	Birden çok uygulama iş parçacığı kısıtlama olmadan MPI işlevlerini çağırabilir. Bu değer şu anda yalnızca Windows Server 2012, Windows Server 2012 R2, Windows 8 ve Windows 8.1 üzerinde çalışan MS-MPI V6'da desteklenir.

   

• sağlandı [out]
  Sağlanan iş parçacığı desteği düzeyi. Döndürülen değer yukarıdaki tablodan olacaktır.

   

Döndürülen değer

İşlevin başarıyla döndürülip döndürülmediğini MPI_SUCCESS. Çağrı başka nedenlerle başarısız olduysa (geçersiz bağımsız değişkenler gibi) diğer hata kodları.

Fortran'da dönüş değeri IERROR parametresinde depolanır.

Fortran

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

Açıklamalar

Bu işlev yalnızca bir iş parçacığı tarafından çağrılmalıdır. Bu iş parçacığı "Ana İş Parçacığı" olarak bilinir ve MPI_Finalize çağırmak için aynı iş parçacığı olmalıdır.

MPI_Init_thread Fortran bağlaması ARGC ve ARGV parametrelerini kabul etmez.

Gereksinimler

Ürün	HPC Pack 2012 MS-MPI Yeniden Dağıtılabilir Paketi, HPC Pack 2008 R2 MS-MPI Yeniden Dağıtılabilir Paketi, HPC Pack 2008 MS-MPI Yeniden Dağıtılabilir Paketi veya HPC Pack 2008 İstemci Yardımcı Programları
Üst bilgi	Mpi.h; Mpif.h
Kitaplık	Msmpi.lib
DLL	Msmpi.dll

Ayrıca bkz.

MPI Dış İşlevleri

MPI_Finalize

MPI_Init