Bagikan melalui


MPI_Win_lock (Fungsi MPI_Win_lock)

Memulai epoch akses RMA pada proses target.

Sintaks

int MPIAPI MPI_Win_lock(
   int     lock_type,
   int     rank,
   int     assert,
   MPI_Win win
);

Parameter

  • lock_type
    Menunjukkan apakah proses lain dapat mengakses jendela target secara bersamaan (jika MPI_LOCK_SHARED) atau tidak (MPI_LOCK_EXCLUSIVE).

  • rank
    Peringkat jendela terkunci.

  • Menegaskan
    Digunakan untuk mengoptimalkan panggilan ini; nol dapat digunakan sebagai default.

  • Menang
    Objek jendela.

Menampilkan nilai

Mengembalikan MPI_SUCCESS pada keberhasilan. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.

Di Fortran, nilai yang dikembalikan disimpan dalam parameter IERROR .

Fortran

    MPI_WIN_LOCK(LOCK_TYPE, RANK, ASSERT, WIN, IERROR)
        INTEGER LOCK_TYPE, RANK, ASSERT, WIN, IERROR

Keterangan

Nama rutinitas ini menyesatkan. Secara khusus, rutinitas ini tidak perlu diblokir, kecuali ketika proses target adalah proses panggilan.

Implementasi dapat membatasi penggunaan komunikasi RMA yang disinkronkan oleh panggilan kunci ke jendela dalam memori yang dialokasikan oleh MPI_Alloc_mem. Kunci hanya dapat digunakan secara portabel dalam memori tersebut.

Argumen pernyataan digunakan untuk menunjukkan kondisi khusus untuk pagar yang dapat digunakan implementasi untuk mengoptimalkan operasi MPI_Win_fence . Nilai nol selalu benar. Nilai pernyataan lainnya mungkin ataudigabungkan. Pernyataan yang valid untuk MPI_Win_fence adalah:

  • MPI_MODE_NOCHECK - tidak ada proses lain yang menahan, atau akan mencoba memperoleh kunci yang bertentangan, sementara pemanggil memegang kunci jendela. Ini berguna ketika pengecualian bersama dicapai dengan cara lain, tetapi operasi koherensi yang mungkin melekat pada kunci dan membuka kunci panggilan masih diperlukan.

Persyaratan

Produk

Paket HPC Pack 2012 MS-MPI Redistributable, HpC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package atau HPC Pack 2008 Client Utilities

Header

Mpi.h; Mpif.h

Pustaka

Msmpi.lib

DLL

Msmpi.dll

Lihat juga

Fungsi Komunikasi One-Sided MPI