функция MPI_Comm_size

Извлекает количество процессов, участвующих в коммуникаторе, или общее количество доступных процессов.

Синтаксис

int MPIAPI MPI_Comm_size(
        MPI_Comm comm,
  _Out_ int      *size
);

Параметры

• Comm
  Вычислимый коммуникатор. Укажите константу 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 .

Примечание

Стандартный способ изменить количество процессов после инициализации не существует.

 

Требования

Продукт	Распространяемый пакет HPC 2012 MS-MPI, пакет HPC 2008 R2 распространяемый пакет MS-MPI, пакет HPC 2008 MS-MPI распространяемый пакет или служебные программы клиента ПАКЕТА HPC 2008
Заголовок	Mpi.h; Mpif.h
Библиотека	Msmpi.lib
DLL	Msmpi.dll

См. также раздел

Функции коммуникатора MPI

MPI_Comm_rank