Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
MPI_Grequest_free_function , uygulama tanımlı işlev adı için bir yer tutucudur.
Söz dizimi
int MPI_Grequest_free_function(
_In_opt_ void *extra_state
);
Parametreler
-
extra_state [in, isteğe bağlı]
Ek durum.
Döndürülen değer
Tüm geri çağırma işlevleri bir hata kodu döndürür. Kod geri geçirilir ve geri çağırma işlevini çağıran MPI işlevi tarafından hata kodu için uygun şekilde ele alınır. Örneğin, hata kodları döndürülürse geri çağırma işlevi tarafından döndürülen hata kodu, geri çağırma işlevini çağıran MPI işlevi tarafından döndürülür. Hem query_fn hem de free_fn çağıran bir MPI_Waitany ve MPI_Testany çağrısı söz konusu olduğunda, MPI çağrısı son geri çağırma tarafından döndürülen hata kodunu döndürür( free_fn). MPI_Waitsome, MPI_Waitall, MPI_Testsome veya MPI_Testall bir çağrıdaki isteklerden biri veya daha fazlası başarısız olursa MPI çağrısı MPI_ERR_IN_STATUS döndürür. Böyle bir durumda, MPI çağrısına bir dizi durum geçirildiyse, MPI tamamlanmış bir genelleştirilmiş isteğe karşılık gelen durumların her birinde free_fn geri çağırma işlevinin ilgili çağrısı tarafından döndürülen hata kodunu döndürür. Ancak MPI işlevi MPI_STATUSES_IGNORE geçirildiyse, her geri çağırma işlevi tarafından döndürülen tek tek hata kodları kaybolur.
Fortran
SUBROUTINE GREQUEST_FREE_FUNCTION(EXTRA_STATE, IERROR)
INTEGER IERROR
INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE
Açıklamalar
free_fn işlevi, genelleştirilmiş istek serbest bırakıldığında kullanıcı tarafından ayrılan kaynakları temizlemek için çağrılır.
free_fn geri çağırma MPI_ tarafından çağrılır{Wait|Bu geri çağırmayla ilişkili genelleştirilmiş isteği tamamlayan Test}{any|some|all} çağrısı. free_fn , aynı istek için query_fn çağrısından sonra çağrılır. Ancak, MPI çağrısı birden çok genelleştirilmiş isteği tamamladıysa, free_fn geri çağırma işlevlerinin çağrılma sırası MPI tarafından belirtilmez.
free_fn geri çağırma, MPI_Request_free çağrısı tarafından serbestleştirilen genelleştirilmiş istekler için de çağrılır (MPI_{Wait|Test}{any|some|all} böyle bir istek için gerçekleşir). Bu durumda, geri çağırma işlevi MPI çağrı MPI_Request_free veya MPI çağrı MPI_Grequest_complete çağrılır(en son hangisi gerçekleşirse, örneğin, bu durumda gerçek serbest kod hem çağrı MPI_Request_free hem de MPI_Grequest_complete gerçekleşir gerçekleşmez yürütülür). İstek, free_fn tamamlanana kadar serbest bırakılmaz. free_fn doğru bir program tarafından istek başına yalnızca bir kez çağrılacağını unutmayın.
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 |