MPI_Win_allocate işlevi

Bellek ayıran bir MPI Penceresi nesnesi oluşturur.

Söz dizimi

int MPIAPI MPI_Win_allocate(
        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
  Communicator.

• baseptr [out]
  Bellek penceresinin ilk 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(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, en az boyutlu bayt bellek ayırır, buna bir işaretçi döndürür ve 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. Döndürülen bellek, adres baseptr'den başlayarak her işlem için yerel boyut baytlarından oluşur ve kullanıcı tarafından çağrılan MPI_Win_create var olan bellekte olduğu gibi pencereyle ilişkilendirilir. Boyut bağımsız değişkeni her işlemde farklı olabilir ve boyut = 0 geçerlidir; ancak, bir kitaplık hızlı, küresel olarak simetrik ayırma oluşturmak için daha fazla bellek ayırabilir ve kullanıma verebilir.

Gereksinimler

Ayrıca bkz.

MPI One-Sided İletişim İşlevleri