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

pedido [in, out]
Um ponteiro para a alça de MPI_Request de uma operação pendente.
sinalizador [fora]
Na devolução, contém um ponteiro para um número inteiro que indica se o pedido foi concluído. Um valor diferente de zero indica que o pedido está concluído.
status [out]
Na devolução, contém um ponteiro para um objeto MPI_Status que descreve a operação especificada se estiver concluída.

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_WAIT(REQUEST, FLAG, STATUS, IERROR)
        LOGICAL FLAG
        INTEGER REQUEST, STATUS(MPI_STATUS_SIZE), IERROR

Observações

Esta função é uma operação local. A conclusão com êxito não depende de quaisquer operações noutros processos.

Se a operação associada a este pedido tiver sido uma operação de comunicação persistente, o pedido persistente será marcado como inativo. Outras operações são desalocadas e o identificador do pedido está definido como MPI_REQUEST_NULL.

Se o parâmetro do pedido apontar para um valor de MPI_REQUEST_NULL ou para um pedido persistente inativo, a função devolve com o parâmetro de sinalizador definido como um valor diferente de zero e com o parâmetro de estado vazio.

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