funktionen MPI_Irsend

Initierar en skicka-åtgärd i klart läge och returnerar en begärandereferens som representerar kommunikationsåtgärden.

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
);

Parametrar

  • buf [in, optional]
    En pekare till bufferten som innehåller de data som ska skickas. Bufferten består av antal efterföljande element i MPI_Datatype objekt som anges av datatypshandtaget . Meddelandelängden anges i termer av antal element, inte i antal byte. Anroparen bör inte ändra någon del av sändningsbufferten förrän kommunikationsåtgärden har slutförts.

  • Räkna
    Antalet element i buffertmatrisen. Om antalet är noll är datadelen av meddelandet tom.

  • Datatyp
    Ett handtag som representerar datatypen för elementen i bufferten.

  • Dest
    Rangordningen för målprocessen i comm-parametern communicator.

  • Etiketten
    Meddelandetaggen som används för att skilja mellan olika typer av meddelanden.

  • Comm
    Handtaget till kommunikatören.

  • begäran [ut]
    Vid retur pekar du på en referens som representerar kommunikationsåtgärden.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_IRSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, REQUEST, IERROR

Kommentarer

Den här funktionen kan returneras innan meddelandet kopierades från bufferten för att skicka. Den här funktionen är lokal och returneras omedelbart, oavsett status för andra processer. Se kommentarerna för funktionen MPI_Rsend för beskrivningen av det färdiga kommunikationsläget.

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

Se även

MPI punkt-till-punkt-funktioner

MPI_Rsend

MPI_Recv

MPI_Irecv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype