MPI_Irsend-Funktion

Initiiert einen Sendevorgang im bereiten Modus und gibt ein Anforderungshandle zurück, das den Kommunikationsvorgang darstellt.

Syntax

int MPIAPI MPI_Irsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm,
  _Out_    MPI_Request  *request
);

Parameter

• buf [in, optional]
  Ein Zeiger auf den Puffer, der die zu sendenden Daten enthält. Der Puffer besteht aus der Anzahl aufeinanderfolgender Elemente des MPI_Datatype -Objekts, das durch das Datentyphandle angegeben wird. Die Nachrichtenlänge wird in Bezug auf die Anzahl der Elemente angegeben, nicht in der Anzahl der Bytes. Der Aufrufer sollte keinen Teil des Sendepuffers ändern, bis der Kommunikationsvorgang abgeschlossen ist.

• count
  Die Anzahl der Elemente im Pufferarray. Wenn die Anzahl null ist, ist der Datenteil der Nachricht leer.

• datatype
  Ein Handle, das den Datentyp der Elemente im Puffer darstellt.

• Dest
  Der Rang des Zielprozesses innerhalb des comm-Parameters communicator.

• tag
  Das Nachrichtentag, das verwendet wird, um verschiedene Arten von Nachrichten zu unterscheiden.

• comm
  Der Handle für den Kommunikator.

• Anforderung [out]
  Bei der Rückgabe ein Zeiger auf ein Handle, das den Kommunikationsvorgang darstellt.

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_IRSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, REQUEST, IERROR

Hinweise

Diese Funktion kann zurückgegeben werden, bevor die Nachricht aus dem Sendepuffer kopiert wurde. Diese Funktion ist lokal und gibt sofort zurück, unabhängig von der status anderer Prozesse. Die Beschreibung des bereiten Kommunikationsmodus finden Sie in den Anmerkungen zur MPI_Rsend-Funktion .

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

MPI_Rsend

MPI_Recv

MPI_Irecv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype