MPI_Waitany işlevi

Birkaç bekleyen işlemden birini tamamlar.

Söz dizimi

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

Parametreler

• Sayısı
  array_of_requests parametresindeki girdilerin sayısı.

• array_of_requests
  Bekleyen işlemlerin MPI_Request tanıtıcılarından oluşan bir dizi.

• index [out]
  Tamamlanan işlemin array_of_requests parametresindeki dizini gösteren bir tamsayı işaretçisi. Dizi, C'de sıfırdan ve Fortran'da bir dizine eklenir.

• status [out]
  Tamamlanan işlemi açıklayan MPI_Status nesnesinin işaretçisi.

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_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
        INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR

Açıklamalar

Bu işlev yerel olmayan bir işlemdir. Başarılı tamamlama işlemi, diğer işlemlerde eşleşen işlemlere bağlı olabilir.

Bu işlev, array_of_requests parametresindeki etkin isteklerle ilişkili işlemlerden biri tamamlandığında döndürür. Birden fazla bekleyen işlem tamamlanırsa, rastgele bir işlem seçilir. Tamamlanan işlem kalıcı bir iletişim işlemiyse, kalıcı istek etkin değil olarak işaretlenir. Kalıcı olmayan bir işlem serbest bırakılır ve array_of_requests parametresindeki ilgili girdisi MPI_REQUEST_NULL olarak ayarlanır.

array_of_requests parametresindeki girişler MPI_REQUEST_NULL veya etkin olmayan bir kalıcı iletişim isteğinin tanıtıcısı olabilir. count parametresi sıfırsa veya array_of_requests içindeki tüm girişler MPI_REQUEST_NULL veya etkin olmayan kalıcı iletişim istekleriyse, işlev dizin parametresi MPI_UNDEFINED olarak ayarlanmış ve boş bir durumla hemen geri döner.

Gereksinimler

Ürün	HPC Pack 2012 MS-MPI Yeniden Dağıtılabilir Paketi, HPC Pack 2008 R2 MS-MPI Yeniden Dağıtılabilir Paketi, HPC Pack 2008 MS-MPI Yeniden Dağıtılabilir Paketi veya HPC Pack 2008 İstemci Yardımcı Programları
Üst bilgi	Mpi.h; Mpif.h
Kitaplık	Msmpi.lib
DLL	Msmpi.dll

Ayrıca bkz.

MPI Noktadan Noktaya İşlevler

MPI_Testany

MPI_Wait

MPI_Waitall

MPI_Waitsome

MPI_Status