fungsi MPI_Waitany

Artikel
11/27/2023

Menyelesaikan satu dari beberapa operasi yang luar biasa.

Sintaks

int MPIAPI MPI_Waitany(
        int                              count,
        _Inout_count_(count) MPI_Request *array_of_requests,
  _Out_ int                              *index,
  _Out_ MPI_Status                       *status
);

Parameter

hitung
Jumlah entri dalam parameter array_of_requests .
array_of_requests
Array MPI_Request menangani operasi yang luar biasa.
index [out]
Penunjuk ke bilangan bulat yang menunjukkan indeks dalam parameter array_of_requests operasi yang selesai. Array diindeks dari nol di C, dan dari satu di Fortran.
status [out]
Penunjuk ke objek MPI_Status yang menjelaskan operasi yang telah selesai.

Nilai kembali

Mengembalikan MPI_SUCCESS pada keberhasilan. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.

Di Fortran, nilai pengembalian disimpan dalam parameter IERROR .

Fortran

    MPI_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
        INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR

Keterangan

Fungsi ini adalah operasi non-lokal. Penyelesaian yang berhasil mungkin bergantung pada operasi yang cocok pada proses lain.

Fungsi ini kembali ketika salah satu operasi yang terkait dengan permintaan aktif dalam parameter array_of_requests selesai. Jika lebih dari satu operasi yang luar biasa selesai, satu akan dipilih secara segan. Jika operasi yang selesai adalah operasi komunikasi persisten, permintaan persisten ditandai sebagai tidak aktif. Operasi yang tidak konsisten dibatalkan alokasinya, dan entri yang sesuai dalam parameter array_of_requests diatur ke MPI_REQUEST_NULL.

Entri dalam parameter array_of_requests dapat MPI_REQUEST_NULL atau handel ke permintaan komunikasi persisten yang tidak aktif. Jika parameter hitungan nol, atau semua entri dalam array_of_requestsMPI_REQUEST_NULL atau permintaan komunikasi persisten yang tidak aktif, maka fungsi segera kembali dengan parameter indeks yang diatur ke MPI_UNDEFINED dan status kosong.

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