função MPI_Waitany

Conclui uma de várias operações pendentes.

Sintaxe

int MPIAPI MPI_Waitany(
        int                              count,
        _Inout_count_(count) MPI_Request *array_of_requests,
  _Out_ int                              *index,
  _Out_ MPI_Status                       *status
);

Parâmetros

• contagem
  O número de entradas no parâmetro array_of_requests .

• array_of_requests
  Uma matriz de identificadores MPI_Request de operações pendentes.

• index [out]
  Um ponteiro para um inteiro que indica o índice no parâmetro array_of_requests da operação concluída. A matriz é indexada de zero em C e de uma em Fortran.

• status [out]
  Um ponteiro para um objeto MPI_Status que descreve a operação concluída.

Retornar valor

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

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

Fortran

    MPI_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
        INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR

Comentários

Essa função é uma operação não local. A conclusão bem-sucedida pode depender de operações correspondentes em outros processos.

Essa função retorna quando uma das operações associadas a solicitações ativas no parâmetro array_of_requests é concluída. Se mais de uma operação pendente for concluída, uma será escolhida arbitrariamente. Se a operação concluída for uma operação de comunicação persistente, a solicitação persistente será marcada como inativa. Uma operação não persistente é desalocada e sua entrada correspondente no parâmetro array_of_requests é definida como MPI_REQUEST_NULL.

As entradas no parâmetro array_of_requests podem ser MPI_REQUEST_NULL ou um identificador para uma solicitação de comunicação persistente inativa. Se o parâmetro count for zero ou todas as entradas no array_of_requests forem MPI_REQUEST_NULL ou solicitações de comunicação persistentes inativas, a função retornará imediatamente com o parâmetro de índice definido como MPI_UNDEFINED e um status vazio.

Requisitos

Confira também

Funções ponto a ponto do MPI

MPI_Testany

MPI_Wait

MPI_Waitall

MPI_Waitsome

MPI_Status