MPI_Comm_size函式
擷取與通訊器相關的進程數目，或可用的進程總數。
語法
int MPIAPI MPI_Comm_size(
MPI_Comm comm,
_Out_ int *size
);
參數
通訊
要評估的通訊器。 指定 MPI_COMM_WORLD 常數，以擷取可用的進程總數。size [out]
傳回時，表示通訊器群組中的進程數目。
傳回值
傳回成功時 MPI_SUCCESS 。 否則，傳回值是錯誤碼。
在 Fortran 中，傳回值會儲存在 IERROR 參數中。
Fortran
MPI_COMM_SIZE(COMM,SIZE,IERROR)
INTEGER COMM, SIZE, IERROR
備註
此函式可讓使用者使用單一函式呼叫來擷取群組大小。 否則，必須使用 MPI_Comm_group 函式建立暫存群組、使用 MPI_Group_size 函式取得群組的大小，然後使用 MPI_Group_free 函式釋放暫存群組。
此函式通常與 MPI_Comm_rank 函式搭配使用，以判斷特定程式庫或程式可用的並行數量。 MPI_Comm_rank函式指出呼叫其範圍從 0 到size-1的進程排名，其中會使用MPI_Comm_size函式來擷取size。
注意
在初始化完成之後，沒有任何標準方式可以變更進程數目。
規格需求
產品 |
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 |