fungsi MPI_Init_thread

Menginisialisasi lingkungan eksekusi proses MPI panggilan untuk eksekusi utas.

Sintaks

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

Parameter

• argc [in, opsional]
  Penunjuk ke jumlah argumen untuk program. Nilai ini bisa NULL.

• argv [opsional]
  Penunjuk ke daftar argumen untuk program. Nilai ini bisa NULL.

• required [in]
  Tingkat dukungan utas yang diinginkan. Beberapa proses MPI dalam pekerjaan yang sama dapat menggunakan nilai yang berbeda.

  MPI_THREAD_SINGLE	Hanya satu utas dalam program yang akan dijalankan.
  MPI_THREAD_FUNNELED	Proses ini mungkin berisi beberapa utas, tetapi utas yang disebut MPI_Init_thread adalah satu-satunya yang melakukan panggilan fungsi MPI.
  MPI_THREAD_SERIALIZED	Proses ini mungkin berisi beberapa utas, dan semua utas tersebut dapat melakukan panggilan fungsi MPI, tetapi hanya satu per satu.
  MPI_THREAD_MULTIPLE	Beberapa utas aplikasi dapat memanggil fungsi MPI tanpa batasan. Nilai ini saat ini hanya didukung pada MS-MPI V6 yang berjalan pada Windows Server 2012, Windows Server 2012 R2, Windows 8, dan Windows 8.1.

   

• disediakan [out]
  Tingkat dukungan utas yang disediakan. Nilai yang dikembalikan akan berasal dari tabel di atas.

   

Menampilkan nilai

MPI_SUCCESS jika fungsi berhasil dikembalikan. Kode kesalahan lain jika panggilan gagal karena alasan lain (seperti argumen yang tidak valid).

Di Fortran, nilai yang dikembalikan disimpan dalam parameter IERROR .

Fortran

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

Keterangan

Fungsi ini harus dipanggil oleh satu utas saja. Utas itu akan dikenal sebagai "Utas Utama" dan harus utas yang sama untuk memanggil MPI_Finalize.

Pengikatan Fortran MPI_Init_thread tidak menerima parameter ARGC dan ARGV.

Persyaratan

Produk	Paket HPC Pack 2012 MS-MPI Redistributable, HpC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package atau HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Pustaka	Msmpi.lib
DLL	Msmpi.dll

Lihat juga

Fungsi Eksternal MPI

MPI_Finalize

MPI_Init