funzione MPI_Waitsome
Completa alcune operazioni in sospeso.
Sintassi
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
);
Parametri
incount
Numero di voci nel parametro array_of_requests .array_of_requests
Matrice di MPI_Request handle delle operazioni in sospeso.outcount [out ]
Numero di richieste completate.array_of_indices
Matrice di indici nella array_of_requests delle operazioni completate. Il array_of_requests viene indicizzato da zero in C e da uno in Fortran.array_of_statuses
Matrice di oggetti di stato per operazioni completate o MPI_STATUSES_IGNORE.
Valore restituito
Restituisce MPI_SUCCESS sull'esito positivo. In caso contrario, il valore restituito è un codice di errore.
In Fortran il valore restituito viene archiviato nel parametro 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
Commenti
La matrice di indici si trova nell'intervallo da 0 a 1 per C e nell'intervallo da 1a conteggio per Fortran.
Le richieste NULL vengono ignorate; se tutte le richieste sono NULL, la routine restituisce con il conteggio impostato su MPI_UNDEFINED.
Anche se è possibile elencare un handle di richiesta più di una volta nella array_of_requests, tale azione viene considerata errata e può causare l'annullamento o la generazione di risultati non corretti del programma.
MPI_Waitsome fornisce un'interfaccia molto simile alle chiamate unix 'select' o 'poll' e, in un'implementazione di qualità elevata, indica tutte le richieste completate quando viene chiamato MPI_Waitsome . Tuttavia, MPI_Waitsome garantisce solo che almeno una richiesta sia stata completata; non vi è alcuna garanzia che tutte le richieste completate verranno restituite o che le voci in array_of_indices saranno in ordine crescente. Inoltre, le richieste completate durante l'esecuzione di MPI_Waitsome possono essere restituite o meno, a seconda del tempo di completamento del messaggio.
Requisiti
Prodotto |
Pacchetto ridistribuibile HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Utilità client |
Intestazione |
Mpi.h; Mpif.h |
Libreria |
Msmpi.lib |
DLL |
Msmpi.dll |