MPI_Type_create_keyval函式

建立 MPI 資料類型的屬性索引鍵值。

語法

int MPIAPI MPI_Type_create_keyval(
  _In_     MPI_Type_copy_attr_function   *type_copy_attr_fn,
  _In_     MPI_Type_delete_attr_function *type_delete_attr_fn,
  _Out_    int                           *type_keyval,
  _In_opt_ void                          *extra_state
);

參數

• type_copy_attr_fn [in]
  複製 type_keyval的回呼函式。

• type_delete_attr_fn [in]
  刪除 type_keyval的回呼函式。

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

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

傳回值

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

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

Fortran

    MPI_TYPE_CREATE_KEYVAL(TYPE_COPY_ATTR_FN, TYPE_DELETE_ATTR_FN, TYPE_KEYVAL,
                EXTRA_STATE, IERROR)
        EXTERNAL TYPE_COPY_ATTR_FN, TYPE_DELETE_ATTR_FN
        INTEGER TYPE_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE

備註

預設的複製和刪除函式可供使用。 它們是：

• MPI_TYPE_NULL_COPY_FN - 空白複製函式
• MPI_TYPE_NULL_DELETE_FN - 空白刪除函式
• MPI_TYPE_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_Type_copy_attr_function

MPI_Type_delete_attr_function