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 |