MPI_Cancel-Funktion

Bricht eine Kommunikationsanforderung ab.

Syntax

int MPIAPI MPI_Cancel(
  _In_ MPI_Request *request
);

Parameter

• Anforderung [in]
  Kommunikationsanforderung.

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

    MPI_CANCEL(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

Hinweise

Die primäre erwartete Verwendung von MPI_Cancel ist in Multipufferungsschemas, bei denen spekulative MPI_Irecvgemacht werden. Wenn die Berechnung abgeschlossen ist, können einige dieser Empfangsanforderungen erhalten bleiben. Mithilfe von MPI_Cancel kann der Benutzer diese nicht erfüllten Anforderungen abbrechen.

Das Abbrechen eines Sendevorgangs ist viel schwieriger, zum großen Teil, weil der Sendevorgang in der Regel zumindest teilweise abgeschlossen ist (die Informationen zu Tag, Größe und Quelle werden in der Regel sofort an das Ziel gesendet). Benutzer werden darauf hingewiesen, dass das Abbrechen eines Sendens, während ein lokaler Vorgang (wie im MPI-Standard definiert) wahrscheinlich teuer ist (in der Regel das Generieren einer oder mehrerer interner Nachrichten).

Anforderungen

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliothek	Msmpi.lib
DLL	Msmpi.dll

Weitere Informationen

MPI-Punkt-zu-Punkt-Funktionen