MPI_Mprobe functie
Tests voor een bericht blokkeren. Biedt een mechanisme voor het ontvangen van het specifieke bericht dat overeenkomt, ongeacht de tussenliggende test-/ontvangstbewerkingen. Het overeenkomende bericht wordt verwijderd uit de wachtrij voor ontvangst, zodat de toepassing de mogelijkheid krijgt om te bepalen hoe het bericht moet worden ontvangen op basis van de informatie die door de overeenkomende testbewerking wordt geretourneerd. Het overeenkomende bericht wordt vervolgens ontvangen met behulp van de functie MPI_Mrecv of MPI_Imrecv .
Syntaxis
int MPIAPI MPI_Mprobe(
_In_ int source,
_In_ int tag,
_In_ MPI_Comm comm,
_Out_ MPI_Message *message,
_Out_ MPI_Status *status
);
Parameters
bron [in]
Bronrang of MPI_ANY_SOURCE.tag [in]
Berichttag of MPI_ANY_TAG.comm [in]
MPI communicator handvat.bericht [uit]
Bij terugkomst bevat een verwijzing naar het overeenkomende bericht.status [uit]
Bij terugkomst bevat een verwijzing naar een MPI_Status structuur waarin informatie over het bericht wordt opgeslagen.
Retourwaarde
Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.
In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .
Fortran
MPI_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR
Opmerkingen
Deze functie gedraagt zich als MPI_Improbe , behalve dat het een blokkerende aanroep is die pas wordt geretourneerd nadat een overeenkomend bericht is gevonden.
Vereisten
Product |
Microsoft MPI v6 |
Header |
Mpi.h; Mpif.h |
Bibliotheek |
Msmpi.lib |
DLL |
Msmpi.dll |