MPI_Cancel functie
Hiermee annuleert u een communicatieaanvraag.
Syntaxis
int MPIAPI MPI_Cancel(
_In_ MPI_Request *request
);
Parameters
-
aanvraag [in]
Communicatieaanvraag.
Retourwaarde
Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.
In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .
Fortran
MPI_CANCEL(REQUEST, IERROR)
INTEGER REQUEST, IERROR
Opmerkingen
Het primaire verwachte gebruik van MPI_Cancel is in multibufferingschema's, waarbij speculatieve MPI_Irecvworden gemaakt. Wanneer de berekening is voltooid, kunnen sommige van deze ontvangstaanvragen behouden blijven; met behulp van MPI_Cancel kan de gebruiker deze ontevreden aanvragen annuleren.
Het annuleren van een verzendbewerking is veel moeilijker, grotendeels omdat het verzenden meestal ten minste gedeeltelijk is voltooid (de informatie over de tag, de grootte en de bron wordt meestal onmiddellijk naar de bestemming verzonden). Gebruikers wordt geadviseerd dat het annuleren van een verzendbewerking, terwijl een lokale bewerking (zoals gedefinieerd door de MPI-standaard), waarschijnlijk duur is (meestal het genereren van een of meer interne berichten).
Vereisten
Product |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliotheek |
Msmpi.lib |
DLL |
Msmpi.dll |