MPI_Mprobe fonction
Blocage des sondes pour un message. Fournit un mécanisme pour recevoir le message spécifique qui a été mis en correspondance, quelles que soient les opérations de sonde/réception intervenantes. Le message correspondant est supprimé de la file d’attente de réception, ce qui permet à l’application de décider comment recevoir le message en fonction des informations retournées par l’opération de sonde correspondante. Le message correspondant est ensuite reçu à l’aide de la fonction MPI_Mrecv ou MPI_Imrecv .
Syntaxe
int MPIAPI MPI_Mprobe(
_In_ int source,
_In_ int tag,
_In_ MPI_Comm comm,
_Out_ MPI_Message *message,
_Out_ MPI_Status *status
);
Paramètres
source [in]
Classement source ou MPI_ANY_SOURCE.balise [in]
Balise de message ou MPI_ANY_TAG.comm [in]
Handle du communicateur MPI.message [out]
Au retour, contient un pointeur vers le message correspondant.status [out]
Au retour, contient un pointeur vers une structure MPI_Status où sont stockées des informations sur le message.
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_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR
Remarques
Cette fonction se comporte comme MPI_Improbe sauf qu’il s’agit d’un appel bloquant qui retourne uniquement une fois qu’un message correspondant a été trouvé.
Configuration requise
Produit |
Microsoft MPI v6 |
En-tête |
Mpi.h ; Mpif.h |
Bibliothèque |
Msmpi.lib |
DLL |
Msmpi.dll |