função MPI_Waitsome
Conclui algumas das várias operações pendentes.
Sintaxe
int MPIAPI MPI_Waitsome(
int incount,
_Inout_count_(incount) MPI_Request array_of_requests,
_Out_ int *outcount,
_Out_cap_post_count_(incount,*outcount) int *array_of_indices,
_Out_cap_post_count_(incount,*outcount) *array_of_statuses
);
Parâmetros
conta
O número de entradas no parâmetro array_of_requests .array_of_requests
Uma matriz de MPI_Request processa operações pendentes.outcount [out]
O número de pedidos concluídos.array_of_indices
Matriz de índices na array_of_requests de operações que foram concluídas. O array_of_requests é indexado de zero em C e de um em Fortran.array_of_statuses
Matriz de objetos de estado para operações concluídas ou MPI_STATUSES_IGNORE.
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_WAITSOME(INCOUNT, ARRAY_OF_REQUESTS, OUTCOUNT, ARRAY_OF_INDICES, ARRAY_OF_STATUSES, IERROR)
INTEGER INCOUNT, ARRAY_OF_REQUESTS(*), OUTCOUNT, ARRAY_OF_INDICES(*),
ARRAY_OF_STATUSES(MPI_STATUS_SIZE,*), IERROR
Observações
A matriz de índices está no intervalo 0 a contar - 1 para C e no intervalo 1 a contar para Fortran.
Os pedidos NULL são ignorados; se todos os pedidos forem NULL, a rotina é devolvida com a contagem definida como MPI_UNDEFINED.
Embora seja possível listar um identificador de pedido mais do que uma vez no array_of_requests, tal ação é considerada errada e pode fazer com que o programa termine de forma não específica ou produza resultados incorretos.
MPI_Waitsome fornece uma interface semelhante às chamadas unix "select" ou "poll" e, numa implementação de elevada qualidade, indica todos os pedidos que foram concluídos quando MPI_Waitsome é chamado. No entanto, MPI_Waitsome apenas garante que pelo menos um pedido foi concluído; não há garantias de que todos os pedidos concluídos serão devolvidos ou que as entradas no array_of_indices estarão por ordem crescente. Além disso, os pedidos que são concluídos enquanto MPI_Waitsome está a ser executado podem ou não ser devolvidos, dependendo da temporização da conclusão da mensagem.
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 |