MPI_Win_allocate_shared işlevi

Belleği ayıran bir MPI Penceresi nesnesi oluşturur, ayrılmış belleğe doğrudan yükleme/depolama yönergeleriyle pencerenin grubundaki tüm işlemlerden erişilebilir.

Söz dizimi

int MPIAPI MPI_Win_allocate_shared(
        MPI_Aint size,
        int      disp_unit,
        MPI_Info info,
        MPI_Comm comm,
  _Out_ void     *baseptr,
  _Out_ MPI_Win  *win
);

Parametreler

• Boyutu
  Bellek penceresinin bayt cinsinden boyutu.

• disp_unit
  Yer değiştirmeler için bayt cinsinden yerel birim boyutu.

• Bilgi
  Bilgi bağımsız değişkeni.

• Comm
  İletişim içi.

• baseptr [out]
  Yerel ayrılan pencere kesiminin adresi.

• win [out]
  Çağrı tarafından döndürülen pencere nesnesi.

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_WIN_ALLOCATE_SHARED(SIZE, DISP_UNIT, INFO, COMM, BASEPTR, WIN, IERROR)
        <type> BASEPTR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) SIZE
        INTEGER DISP_UNIT, INFO, COMM, WIN, IERROR

Açıklamalar

Bu, comm grubundaki tüm işlemler tarafından yürütülen toplu bir çağrıdır. Her işlemde, comm'daki tüm işlemler arasında paylaşılan en az boyutlu bayt bellek ayırır ve baseptr'de çağıran işlemdeki yük/depolama erişimleri için kullanılabilecek yerel olarak ayrılmış kesime yönelik bir işaretçi döndürür. Yerel olarak ayrılan bellek, uzak işlemler tarafından yapılan yükleme/depolama erişimlerinin hedefi olabilir; diğer işlemlerin temel işaretçileri , işlev MPI_Win_shared_query kullanılarak sorgulanabilir. Çağrısı ayrıca, RMA işlemlerini gerçekleştirmek için comm'daki tüm işlemler tarafından kullanılabilecek bir pencere nesnesi döndürür. Boyut bağımsız değişkeni her işlemde farklı olabilir ve boyut = 0 geçerlidir. Communicator iletişiminin gruptaki tüm işlemler tarafından erişilebilen bir paylaşılan bellek kesimi oluşturabilen bir işlem grubunu temsil etmesini sağlamak kullanıcının sorumluluğundadır.

Gereksinimler

Ayrıca bkz.

MPI One-Sided İletişim İşlevleri