MPI_Win_create_keyval函式

建立 MPI 視窗物件的屬性索引鍵值。

語法

int MPIAPI MPI_Win_create_keyval(
  _In_     MPI_Win_copy_attr_function   *win_copy_attr_fn,
  _In_     MPI_Win_delete_attr_function *win_delete_attr_fn,
  _Out_    int                          *win_keyval,
  _In_opt_ void                         *extra_state
);

參數

• win_copy_attr_fn [in]
  複製 win_keyval的回呼函式。

• win_delete_attr_fn [in]
  刪除 win_keyval的回呼函式。

• win_keyval [out]
  未來存取的索引鍵值。

• extra_state [in， 選擇性]
  回呼函式的額外狀態。

傳回值

傳回成功 時MPI_SUCCESS 。 否則，傳回值是錯誤碼。

在 Fortran 中，傳回值會儲存在 IERROR 參數中。

Fortran

    MPI_WIN_CREATE_KEYVAL(WIN_COPY_ATTR_FN, WIN_DELETE_ATTR_FN, WIN_KEYVAL,
                EXTRA_STATE, IERROR)
        EXTERNAL WIN_COPY_ATTR_FN, WIN_DELETE_ATTR_FN
        INTEGER WIN_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE

備註

默認複製和刪除函式可供使用。 它們是：

• MPI_WIN_NULL_COPY_FN - 空白複製函式
• MPI_WIN_NULL_DELETE_FN - 空白刪除函式
• MPI_WIN_DUP_FN - 簡單 dup 函式

規格需求

產品	HPC Pack 2012 MS-MPI 可轉散發套件、HPC Pack 2008 R2 MS-MPI 可轉散發套件、HPC Pack 2008 MS-MPI 可轉散發套件或 HPC Pack 2008 用戶端公用程式
標頭	Mpi.h;Mpif.h
媒體櫃	Msmpi.lib
DLL	Msmpi.dll

另請參閱

MPI 快取函式

MPI_Win_delete_attr_function

MPI_Win_copy_attr_function