fungsi MPI_Mprobe
Memblokir pemeriksaan untuk pesan. Menyediakan mekanisme untuk menerima pesan tertentu yang cocok terlepas dari intervensi operasi pemeriksaan/penerimaan. Pesan yang cocok tidak diantrekan dari antrean terima, memberi aplikasi kesempatan untuk memutuskan cara menerima pesan berdasarkan informasi yang dikembalikan oleh operasi pemeriksaan yang cocok. Pesan yang cocok kemudian diterima menggunakan fungsi MPI_Mrecv atau MPI_Imrecv .
Sintaks
int MPIAPI MPI_Mprobe(
_In_ int source,
_In_ int tag,
_In_ MPI_Comm comm,
_Out_ MPI_Message *message,
_Out_ MPI_Status *status
);
Parameter
source [in]
Peringkat sumber atau MPI_ANY_SOURCE.tag [in]
Tag pesan atau MPI_ANY_TAG.comm [in]
Handel komunikator MPI.message [out]
Saat kembali, berisi penunjuk ke pesan yang cocok.status [out]
Saat kembali, berisi penunjuk ke struktur MPI_Status tempat informasi tentang pesan disimpan.
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_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR
Keterangan
Fungsi ini berkinerja seperti MPI_Improbe kecuali bahwa itu adalah panggilan pemblokiran yang hanya kembali setelah pesan yang cocok ditemukan.
Persyaratan
Produk |
Microsoft MPI v6 |
Header |
Mpi.h; Mpif.h |
Pustaka |
Msmpi.lib |
DLL |
Msmpi.dll |