共用方式為

MPI_Comm_get_attr函式

  • 發行項

依索引鍵擷取屬性值。

語法

int MPIAPI MPI_Comm_get_attr(
        MPI_Comm comm,
        int      comm_keyval,
  _Out_ void     *attribute_val,
  _Out_ int      *flag
);

參數

  • 通訊
    附加屬性的 Communicator。

  • comm_keyval
    索引鍵值。

  • attribute_val [out]
    屬性值，除非 flag = false。

  • 旗標 [out]
    如果擷取屬性值，則為 True;如果沒有任何屬性與索引鍵相關聯，則為 false。

傳回值

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

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

Fortran

    MPI_COMM_GET_ATTR(COMM, COMM_KEYVAL, ATTRIBUTE_VAL, FLAG, IERROR)
        INTEGER COMM, COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) ATTRIBUTE_VAL
        LOGICAL FLAG

備註

屬性必須擷取自與插入MPI_Comm_set_attr相同的語言。 即使 attribute_val 自變數宣告為 void 指標，但它實際上是 void 指標的位址。 如需詳細資訊，請參閱標準中的原理。

規格需求

產品

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 快取函式