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

Lihat juga

Fungsi Titik ke Titik MPI

MPI_Improbe

MPI_Recv

MPI_Imrecv