MPI_Improbe işlevi

Engelleyici olmayan bir yolla ileti için yoklamalar. Araya girme araştırma/alma işlemlerine bakılmaksızın eşleşen belirli iletiyi almak için bir mekanizma sağlar. Eşleşen ileti alma kuyruğundan çıkarılır ve uygulamaya engelleyici olmayan eşleştirme yoklama işlemi tarafından döndürülen bilgilere göre iletiyi nasıl alacağına karar verme fırsatı verir. Eşleşen ileti daha sonra MPI_Mrecv veya MPI_Imrecv işlevi kullanılarak alınır.

Söz dizimi

int MPIAPI MPI_Improbe(
  _In_  int         source,
  _In_  int         tag,
  _In_  MPI_Comm    comm,
  _Out_ Int         *flag,
  _Out_ MPI_Message *message,
  _Out_ MPI_Status  *status
);

Parametreler

• kaynak [in]
  Kaynak derecesi veya MPI_ANY_SOURCE.

• etiket [in]
  İleti etiketi veya MPI_ANY_TAG.

• comm [in]
  MPI iletişimleyici tutamacı.

• flag [out]
  Dönüşte, belirtilen kaynak, etiket ve virgülün eşleşip eşleşmediğini gösteren bir tamsayı işaretçisi içerir. Sıfır olmayan bir değer, parametrelerin eşleştirildiğini gösterir.

• ileti [out]
  Dönüşte, eşleşen iletiye yönelik bir işaretçi içerir.

• status [out]
  Dönüşte, iletiyle ilgili bilgilerin depolandığı MPI_Status yapısının işaretçisini içerir.

Döndürülen değer

Başarılı MPI_SUCCESS döndürür. Aksi takdirde, dönüş değeri bir hata kodudur.

Fortran'da, dönüş değeri IERROR parametresinde depolanır.

Fortran

    MPI_IMPROBE(SOURCE, TAG, COMM, FLAG, MESSAGE, STATUS, IERROR)
          INTEGER SOURCE, TAG, COMM, FLAG, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR

Açıklamalar

Bu işlev, alınabilen ve bağımsız değişken kaynağı, etiketi ve comm tarafından belirtilen desenle eşleşen bir ileti varsatruebayrağını = döndürür. Çağrı, programda aynı noktada yürütülen MPI_Recv çağrısı tarafından alınan iletiyle eşleşir ve durum olarak MPI_Recv tarafından döndürülecek değeri döndürür. Buna ek olarak, iletide eşleşen iletinin tanıtıcısını döndürür. Aksi takdirde, çağrıfalsebayrağını = döndürür ve durum ile iletiyi tanımsız bırakır.

Gereksinimler

Ürün	Microsoft MPI v6
Üst bilgi	Mpi.h; Mpif.h
Kitaplık	Msmpi.lib
DLL	Msmpi.dll

Ayrıca bkz.

MPI Noktadan Noktaya İşlevler

MPI_Mprobe

MPI_Recv

MPI_Imrecv