MSMPI_Waitsome_interruptible (Fungsi MSMPI_Waitsome_interruptible)
Menunggu hingga setidaknya salah satu operasi yang terkait dengan handel aktif dalam daftar telah selesai, atau panggilan terganggu oleh utas lain yang memanggil MSMPI_Queuelock_acquire.
Sintaks
int MPIAPI MSMPI_Waitsome_interruptible(
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) int array_of_statuses[]
);
Parameter
incount
Jumlah permintaan dalam array array_of_requests.array_of_requests
Array handel permintaan operasi untuk menunggu penyelesaian. Jika handel permintaan dialokasikan oleh fungsi komunikasi yang tidak diblokir, maka itu dibatalkan alokasinya, dan handel terkait diatur ke MPI_REQUEST_NULL.outcount [out]
Jumlah permintaan yang ditentukan dalam parameter array_of_requests yang selesai dan jumlah elemen dalam array array_of_indices dan array_of_statuses .Jika array_of_requests tidak berisi handel aktif, maka fungsi segera kembali dengan parameter outcount diatur ke MPI_UNDEFINED.
Jika fungsi ini terganggu sebelum permintaan selesai, maka panggilan kembali dengan parameter outcount diatur ke nol.
array_of_indices
Mengembalikan indeks dalam parameter array_of_requests operasi yang selesai. Indeks array berbasis nol di C dan berbasis satu di Fortran.array_of_statuses
Mengembalikan status operasi yang selesai. Elemen array ini sesuai dengan elemen array array_of_indices .
Menampilkan nilai
Mengembalikan MPI_SUCCESS pada keberhasilan. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.
Di Fortran, nilai yang dikembalikan disimpan dalam parameter IERROR .
Jika fungsi mengembalikan kesalahan selain MPI_ERR_IN_STATUS, fungsi tidak memperbarui bidang kesalahan status dalam parameter array_of_statuses .
Keterangan
Dalam lingkungan multi-utas, pengguna harus mendapatkan kunci MPI Microsoft global dengan menggunakan fungsi MSMPI_Queuelock_acquire sebelum mereka memanggil MSMPI_Waitsome_interruptible. Fungsi ini terganggu ketika utas lain memanggil fungsi MSMPI_Queuelock_acquire untuk mengakses pustaka MPI.
Fungsi ini adalah ekstensi untuk standar.
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 |
Pustaka |
Msmpi.lib |
DLL |
Msmpi.dll |