Função MPI_Test

Artigo
12/27/2023

Testa uma operação pendente para conclusão.

Sintaxe

int MPIAPI MPI_Test(
  _Inout_  MPI_Request *request,
  _Out_   int          *flag,
  _Out_   MPI_Status   *status
);

Parâmetros

request [in, out]
Um ponteiro para o identificador MPI_Request de uma operação pendente.
sinalizador [out]
No retorno, contém um ponteiro para um inteiro que indica se a solicitação foi concluída. Um valor diferente de zero indica que a solicitação foi concluída.
status [out]
No retorno, contém um ponteiro para um objeto MPI_Status que descreve a operação especificada se ela estiver concluída.

Retornar valor

Retorna MPI_SUCCESS com êxito. Caso contrário, o valor retornado será um código de erro.

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

Fortran

    MPI_WAIT(REQUEST, FLAG, STATUS, IERROR)
        LOGICAL FLAG
        INTEGER REQUEST, STATUS(MPI_STATUS_SIZE), IERROR

Comentários

Essa função é uma operação local. A conclusão bem-sucedida não depende de nenhuma operação em outros processos.

Se a operação associada a essa solicitação for uma operação de comunicação persistente, a solicitação persistente será marcada como inativa. Outras operações são desalocadas e o identificador de solicitação é definido como MPI_REQUEST_NULL.

Se o parâmetro de solicitação apontar para um valor de MPI_REQUEST_NULL ou para uma solicitação persistente inativa, a função retornará com o parâmetro de sinalizador definido como um valor diferente de zero e com o parâmetro status vazio.

Requisitos

Produto	Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008
parâmetro	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
DLL	Msmpi.dll