MPI_Waitsome función
Completa algunas de varias operaciones pendientes.
Sintaxis
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
incount
Número de entradas del parámetro array_of_requests .array_of_requests
Matriz de MPI_Request identificadores de operaciones pendientes.outcount [out]
Número de solicitudes completadas.array_of_indices
Matriz de índices en el array_of_requests de operaciones que se completaron. El array_of_requests se indexa de cero en C y de uno en Fortran.array_of_statuses
Matriz de objetos de estado para las operaciones que se completaron o MPI_STATUSES_IGNORE.
Valor devuelto
Devuelve MPI_SUCCESS si se realiza correctamente. De lo contrario, el valor devuelto es un código de error.
En Fortran, el valor devuelto se almacena en el 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
Comentarios
La matriz de indicies se encuentra en el intervalo 0 a incount - 1 para C y en el intervalo 1 a incount para Fortran.
Las solicitudes NULL se omiten; si todas las solicitudes son NULL, la rutina devuelve con el recuento establecidoen MPI_UNDEFINED.
Aunque es posible enumerar un identificador de solicitud más de una vez en el array_of_requests, dicha acción se considera errónea y puede hacer que el programa finalice sin esperar o genere resultados incorrectos.
MPI_Waitsome proporciona una interfaz similar a las llamadas "select" o "poll" de Unix y, en una implementación de alta calidad, indica todas las solicitudes que se han completado cuando se llama a MPI_Waitsome . Sin embargo, MPI_Waitsome solo garantiza que se haya completado al menos una solicitud; no hay ninguna garantía de que se devuelvan todas las solicitudes completadas o de que las entradas de array_of_indices estarán en orden creciente. Además, las solicitudes que se completan mientras se ejecuta MPI_Waitsome pueden o no devolverse, en función del tiempo de finalización del mensaje.
Requisitos
Producto |
Paquete redistribuible DE HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Client Utilities |
Encabezado |
Mpi.h; Mpif.h |
Biblioteca |
Msmpi.lib |
Archivo DLL |
Msmpi.dll |