função MPI_Comm_size
Obtém o número de processos envolvidos num comunicador ou o número total de processos disponíveis.
Sintaxe
int MPIAPI MPI_Comm_size(
MPI_Comm comm,
_Out_ int *size
);
Parâmetros
vírgula
O comunicador a avaliar. Especifique a constante MPI_COMM_WORLD para obter o número total de processos disponíveis.tamanho [out]
Na devolução, indica o número de processos no grupo do comunicador.
Valor devolvido
Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.
Em Fortran, o valor devolvido é armazenado no parâmetro IERROR .
Fortran
MPI_COMM_SIZE(COMM,SIZE,IERROR)
INTEGER COMM, SIZE, IERROR
Observações
Esta função permite ao utilizador obter o tamanho do grupo com uma única chamada de função. Caso contrário, seria necessário criar um grupo temporário com a função MPI_Comm_group , obter o tamanho do grupo com a função MPI_Group_size e, em seguida, libertar o grupo temporário com a função MPI_Group_free .
Esta função é frequentemente utilizada com a função MPI_Comm_rank para determinar a quantidade de simultaneidade que está disponível para uma biblioteca ou programa específico. A função MPI_Comm_rank indica a classificação do processo que o chama no intervalo de 0 a tamanho-1, em que o tamanho é obtido com a função MPI_Comm_size .
Nota
Não existe uma forma padrão de alterar o número de processos após a inicialização.
Requisitos
Produto |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities |
Cabeçalho |
Mpi.h; Mpif.h |
Biblioteca |
Msmpi.lib |
DLL |
Msmpi.dll |