建立新的屬性索引鍵。
語法
int MPIAPI MPI_Comm_create_keyval(
_In_opt_ MPI_Comm_copy_attr_function *comm_copy_attr_fn,
_In_opt_ MPI_Comm_delete_attr_function *comm_delete_attr_fn,
_Out_ int *comm_keyval,
_In_opt_ void *extra_state
);
參數
comm_copy_attr_fn [in， optional]
複製 keyval的回呼函式。comm_delete_attr_fn [in， 選擇性]
刪除 keyval的回呼函式。comm_keyval [out]
未來存取的索引鍵值。extra_state [in， 選擇性]
回呼函式的額外狀態。
傳回值
MPI_SUCCESS
Fortran
MPI_COMM_CREATE_KEYVAL(COMM_COPY_ATTR_FN, COMM_DELETE_ATTR_FN, COMM_KEYVAL,
EXTRA_STATE, IERROR)
EXTERNAL COMM_COPY_ATTR_FN, COMM_DELETE_ATTR_FN
INTEGER COMM_KEYVAL, IERROR
INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE
備註
索引鍵值是全域 (可供任何和所有通訊器) 使用。
預設複製和刪除函式可供使用。 這些是 MPI_COMM_Null_COPY_FN - 空複製函式 MPI_COMM_Null_DELETE_FN - 空白刪除函式 MPI_COMM_DUP_FN - 簡單的 dup 函式
C 和 Fortran 之間有細微的差異，需要以呼叫MPI_Comm_create_keyval的相同語言撰寫 copy_fn 。 這不應該是大部分使用者的問題;只有在同一個程式中同時使用 Fortran 和 C 的程式程式必須確定它們遵循此規則。
規格需求
產品 |
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 |