Função MPI_Init_thread

Inicializa o ambiente de execução do processo de MPI de chamada para execução encadeada.

Sintaxe

int MPIAPI MPI_Init_thread(
  _In_opt_ int                        *argc,
           _In_opt_count_(*argc) char ***argv,
  _In_     int                        required,
  _Out_    int                        *provided
);

Parâmetros

• argc [in, opcional]
  Um ponteiro para o número de argumentos para o programa. Esse valor pode ser NULL.

• argv [opcional]
  Um ponteiro para a lista de argumentos do programa. Esse valor pode ser NULL.

• obrigatório [in]
  O nível de suporte de thread desejado. Vários processos de MPI no mesmo trabalho podem usar valores diferentes.

  MPI_THREAD_SINGLE	Somente um único thread no programa será executado.
  MPI_THREAD_FUNNELED	O processo pode conter vários threads, mas o thread que chamou MPI_Init_thread é o único que faz chamadas de função MPI.
  MPI_THREAD_SERIALIZED	O processo pode conter vários threads e todos esses threads podem fazer chamadas de função MPI, mas apenas uma de cada vez.
  MPI_THREAD_MULTIPLE	Vários threads de aplicativo podem chamar funções MPI sem restrições. Atualmente, esse valor só tem suporte no MS-MPI V6 em execução em Windows Server 2012, Windows Server 2012 R2, Windows 8 e Windows 8.1.

   

• fornecido [out]
  O nível de suporte de thread fornecido. O valor retornado será da tabela acima.

   

Retornar valor

MPI_SUCCESS se a função retornar com êxito. Outros códigos de erro se a chamada falhou por outros motivos (como argumentos inválidos).

Em Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

    MPI_INIT_THREAD(REQUIRED, PROVIDED, IERROR)
        INTEGER REQUIRED, PROVIDED, IERROR

Comentários

Essa função deve ser chamada apenas por um thread. Esse thread será conhecido como "Thread Principal" e deve ser o mesmo thread para chamar MPI_Finalize.

A associação Fortran de MPI_Init_thread não aceita os parâmetros ARGC e ARGV.

Requisitos

Confira também

Funções externas de MPI

MPI_Finalize

MPI_Init