função MPI_Waitany

Artigo
12/27/2023

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 MPI_Request processa operações pendentes.
índice [out]
Um ponteiro para um número inteiro que indica o índice no parâmetro array_of_requests da operação que está concluída. A matriz é indexada a partir 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.

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_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
        INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR

Observações

Esta função é uma operação não local. A conclusão com êxito pode depender de operações de correspondência noutros processos.

Esta função devolve quando uma das operações associadas a pedidos ativos no parâmetro array_of_requests é concluída. Se mais do que uma operação pendente estiver concluída, é escolhida arbitrariamente uma. Se a operação concluída for uma operação de comunicação persistente, o pedido persistente será marcado como inativo. Uma operação nãopersistente é desalocada e a respetiva entrada correspondente no parâmetro array_of_requests está definida como MPI_REQUEST_NULL.

As entradas no parâmetro array_of_requests podem ser MPI_REQUEST_NULL ou um identificador para um pedido de comunicação persistente inativo. Se o parâmetro de contagem for zero ou todas as entradas no array_of_requests forem MPI_REQUEST_NULL ou pedidos de comunicação persistentes inativos, a função devolve imediatamente com o parâmetro de índice definido como MPI_UNDEFINED e um 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