MPI_Comm_copy_attr_function 函式

MPI_Comm_copy_attr_function 是應用程式定義函數名稱的佔位元。

語法

int MPI_Comm_copy_attr_function(
           MPI_Comm oldcomm,
           int      comm_keyval,
  _In_opt_ void     *extra_state,
  _In_     void     *attribute_val_in,
  _Out_    void     *attribute_val_out,
  _Out_    int      *flag
);

參數

• oldcomm
  原始通訊器。

• comm_keyval
  索引鍵值。

• extra_state [in， 選擇性]
  額外狀態。

• attribute_val_in [in]
  來源屬性值。

• attribute_val_out [out]
  目的地屬性值。

• 旗標 [out]
  如果 旗標的 傳回值為 0 或 FALSE，則會在重複的 communicator 中刪除屬性。 否則， (旗標 = 1 或 TRUE) ，新的屬性值會設定為 attribute_val_out中傳回的值。

傳回值

函式會在成功時 傳回MPI_SUCCESS ，並在失敗時傳回錯誤碼。

Fortran

    SUBROUTINE COMM_COPY_ATTR_FUNCTION(OLDCOMM, COMM_KEYVAL, EXTRA_STATE,
                ATTRIBUTE_VAL_IN, ATTRIBUTE_VAL_OUT, FLAG, IERROR)
        INTEGER OLDCOMM, COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE, ATTRIBUTE_VAL_IN,
            ATTRIBUTE_VAL_OUT
        LOGICAL FLAG

備註

當MPI_Comm_dup複製通訊器時，會叫用comm_copy_attr_fn函式。

規格需求

產品	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_Comm_create_keyval