MPI_Comm_size, funkcja

Pobiera liczbę procesów zaangażowanych w komunikator lub łączną liczbę dostępnych procesów.

Składnia

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

Parametry

• Comm
  Komunikator do oceny. Określ stałą MPI_COMM_WORLD , aby pobrać łączną liczbę dostępnych procesów.

• size [out]
  Po powrocie wskazuje liczbę procesów w grupie dla komunikatora.

Wartość zwracana

Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze IERROR .

Fortran

    MPI_COMM_SIZE(COMM,SIZE,IERROR)
        INTEGER COMM, SIZE, IERROR

Uwagi

Ta funkcja umożliwia użytkownikowi pobranie rozmiaru grupy za pomocą pojedynczego wywołania funkcji. W przeciwnym razie należy utworzyć grupę tymczasową przy użyciu funkcji MPI_Comm_group , uzyskać rozmiar grupy przy użyciu funkcji MPI_Group_size , a następnie zwolnić grupę tymczasową przy użyciu funkcji MPI_Group_free .

Ta funkcja jest często używana z funkcją MPI_Comm_rank w celu określenia ilości współbieżności dostępnej dla określonej biblioteki lub programu. Funkcja MPI_Comm_rank wskazuje rangę procesu, który wywołuje go w zakresie od 0 do rozmiaru 1, gdzie rozmiar jest pobierany przy użyciu funkcji MPI_Comm_size .

Uwaga

Nie ma standardowego sposobu zmiany liczby procesów po zainicjowaniu.

 

Wymagania

Produkt	Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

MPI Communicator Functions

MPI_Comm_rank