funktionen MPI_Cancel
Avbryter en kommunikationsbegäran.
Syntax
int MPIAPI MPI_Cancel(
_In_ MPI_Request *request
);
Parametrar
- begäran [in]
Kommunikationsbegäran.
Returvärde
Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.
I Fortran lagras returvärdet i parametern IERROR .
Fortran
MPI_CANCEL(REQUEST, IERROR)
INTEGER REQUEST, IERROR
Kommentarer
Den primära förväntade användningen av MPI_Cancel är i flerbuffertningsscheman, där spekulativa MPI_Irecvs görs. När beräkningen är klar kan vissa av dessa ta emot begäranden. med hjälp av MPI_Cancel låter användaren avbryta dessa otillfredsställande begäranden.
Det är mycket svårare att avbryta en sändningsåtgärd, till stor del eftersom sändningen vanligtvis är åtminstone delvis fullständig (informationen om taggen, storleken och källan skickas vanligtvis omedelbart till målet). Användare rekommenderas att avbryta en sändning, medan en lokal åtgärd (som definieras av MPI-standarden) sannolikt kommer att bli dyrt (vanligtvis genererar ett eller flera interna meddelanden).
Krav
Produkt |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities |
Huvud |
Mpi.h; Mpif.h |
Bibliotek |
Msmpi.lib |
DLL |
Msmpi.dll |