MPI_Cancel fonction
Annule une demande de communication.
Syntaxe
int MPIAPI MPI_Cancel(
_In_ MPI_Request *request
);
Paramètres
-
request [in]
Demande de communication.
Valeur retournée
Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.
Dans Fortran, la valeur de retour est stockée dans le paramètre IERROR .
Fortran
MPI_CANCEL(REQUEST, IERROR)
INTEGER REQUEST, IERROR
Remarques
L’utilisation principale attendue de MPI_Cancel est dans les schémas de mise en mémoire tampon multiple, où des MPI_Irecvspéculatives sont effectuées. Une fois le calcul terminé, certaines de ces demandes de réception peuvent rester ; l’utilisation de MPI_Cancel permet à l’utilisateur d’annuler ces demandes non satisfaites.
L’annulation d’une opération d’envoi est beaucoup plus difficile, en grande partie parce que l’envoi est généralement au moins partiellement terminé (les informations sur l’étiquette, la taille et la source sont généralement envoyées immédiatement à la destination). Les utilisateurs sont informés que l’annulation d’un envoi, alors qu’une opération locale (telle que définie par la norme MPI), est susceptible d’être coûteuse (généralement la génération d’un ou de plusieurs messages internes).
Configuration requise
Produit |
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 |
En-tête |
Mpi.h ; Mpif.h |
Bibliothèque |
Msmpi.lib |
DLL |
Msmpi.dll |