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

Lihat juga

Fungsi Titik ke Titik MPI