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 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 |