MPI_Waitsome (Fungsi MPI_Waitsome)
Menyelesaikan beberapa dari beberapa operasi yang luar biasa.
Sintaks
int MPIAPI MPI_Waitsome(
int incount,
_Inout_count_(incount) MPI_Request array_of_requests,
_Out_ int *outcount,
_Out_cap_post_count_(incount,*outcount) int *array_of_indices,
_Out_cap_post_count_(incount,*outcount) *array_of_statuses
);
Parameter
incount
Jumlah entri dalam parameter array_of_requests .array_of_requests
Array MPI_Request menangani operasi yang luar biasa.outcount [out]
Jumlah permintaan yang telah selesai.array_of_indices
Array indeks dalam array_of_requests operasi yang selesai. Array_of_requests diindeks dari nol di C, dan dari satu di Fortran.array_of_statuses
Array objek status untuk operasi yang selesai, atau MPI_STATUSES_IGNORE.
Mengembalikan nilai
Mengembalikan MPI_SUCCESS pada keberhasilan. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.
Di Fortran, nilai pengembalian disimpan dalam parameter IERROR .
Fortran
MPI_WAITSOME(INCOUNT, ARRAY_OF_REQUESTS, OUTCOUNT, ARRAY_OF_INDICES, ARRAY_OF_STATUSES, IERROR)
INTEGER INCOUNT, ARRAY_OF_REQUESTS(*), OUTCOUNT, ARRAY_OF_INDICES(*),
ARRAY_OF_STATUSES(MPI_STATUS_SIZE,*), IERROR
Keterangan
Array indeks berada dalam rentang 0 hingga incount - 1 untuk C dan dalam rentang 1 hingga incount untuk Fortran.
Permintaan NULL diabaikan; jika semua permintaan NULL, maka rutin kembali dengan outcount diatur ke MPI_UNDEFINED.
Meskipun dimungkinkan untuk mencantumkan handel permintaan lebih dari sekali di array_of_requests, tindakan tersebut dianggap keliru dan dapat menyebabkan program secara tidak terduga mengakhiri atau menghasilkan hasil yang salah.
MPI_Waitsome menyediakan antarmuka seperti panggilan Unix 'pilih' atau 'jajak pendapat' dan, dalam implementasi berkualitas tinggi, menunjukkan semua permintaan yang telah selesai ketika MPI_Waitsome dipanggil. Namun, MPI_Waitsome hanya menjamin bahwa setidaknya satu permintaan telah selesai; tidak ada jaminan bahwa semua permintaan yang telah selesai akan dikembalikan, atau bahwa entri dalam array_of_indices akan meningkat secara berurutan. Selain itu, permintaan yang selesai saat MPI_Waitsome dijalankan mungkin atau mungkin tidak dikembalikan, tergantung pada waktu penyelesaian pesan.
Persyaratan
Produk |
Paket Redistributable HPC Pack 2012 MS-MPI, Paket HpC Pack 2008 R2 MS-MPI Redistributable, Paket HPC Pack 2008 MS-MPI Redistributable Package atau HpC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Pustaka |
Msmpi.lib |
DLL |
Msmpi.dll |