MPI_Mprobe işlevi

İleti için yoklamaları engelleme. 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 uygulama, eşleşen 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_Mprobe(
  _In_  int         source,
  _In_  int         tag,
  _In_  MPI_Comm    comm,
  _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ı.

• 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_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
          INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR

Açıklamalar

Bu işlev , yalnızca eşleşen bir ileti bulunduktan sonra döndürülen bir engelleme çağrısı olması dışında MPI_Improbe gibi davranı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_Improbe

MPI_Recv

MPI_Imrecv