MPI_Waitsome işlevi

Birkaç bekleyen işlemden bazılarını tamamlar.

Söz dizimi

int MPIAPI MPI_Waitsome(
        int                                         incount,
        _Inout_count_(incount) MPI_Request          array_of_requests,
  _Out_ int                                         *outcount,
        _Out_cap_post_count_(incount,*outcount) int *array_of_indices,
        _Out_cap_post_count_(incount,*outcount)     *array_of_statuses
);

Parametreler

• incount
  array_of_requests parametresindeki girdilerin sayısı.

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

• outcount [out]
  Tamamlanan isteklerin sayısı.

• array_of_indices
  Tamamlanan işlemlerin array_of_requests dizin dizisi. array_of_requests, C'de sıfırdan ve Fortran'da bir dizine eklenir.

• array_of_statuses
  Tamamlanan işlemler için durum nesneleri dizisi veya MPI_STATUSES_IGNORE.

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_WAITSOME(INCOUNT, ARRAY_OF_REQUESTS, OUTCOUNT, ARRAY_OF_INDICES, ARRAY_OF_STATUSES, IERROR)
        INTEGER INCOUNT, ARRAY_OF_REQUESTS(*), OUTCOUNT, ARRAY_OF_INDICES(*),
        ARRAY_OF_STATUSES(MPI_STATUS_SIZE,*), IERROR

Açıklamalar

Dizin dizisi, C için 0 ile incount - 1 aralığında ve Fortran için 1 - incount aralığındadır.

NULL istekleri yoksayılır; tüm istekler NULL ise yordam, outcount değeri MPI_UNDEFINED olarak ayarlanmış olarak döndürür.

array_of_requests bir istek tanıtıcısını birden çok kez listelemek mümkün olsa da, böyle bir eylem hatalı olarak kabul edilir ve programın yürütülemez bir şekilde sonlandırmasına veya yanlış sonuçlar üretmesine neden olabilir.

MPI_Waitsome Unix 'select' veya 'poll' çağrılarına çok benzer bir arabirim sağlar ve yüksek niteliğe sahip bir uygulamada , MPI_Waitsome çağrıldığında tamamlanan tüm istekleri gösterir. Ancak MPI_Waitsome yalnızca en az bir isteğin tamamlandığını garanti eder; tamamlanan tüm isteklerin döndürüleceği veya array_of_indices girişlerin artan sırada olacağının garantisi yoktur. Ayrıca, MPI_Waitsome yürütülürken tamamlanan istekler, iletinin tamamlanma zamanlamasına bağlı olarak döndürülebilir veya döndürülmeyebilir.

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