Condividi tramite


funzione MPI_Irsend

Avvia un'operazione di invio in modalità pronta e restituisce un handle di richiesta che rappresenta l'operazione di comunicazione.

Sintassi

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

Parametri

  • buf [in, facoltativo]
    Puntatore al buffer che contiene i dati da inviare. Il buffer è costituito da conteggio degli elementi successivi dell'oggetto MPI_Datatype indicato dall'handle del tipo di dati . La lunghezza del messaggio viene specificata in termini di numero di elementi, non in numero di byte. Il chiamante non deve modificare alcuna parte del buffer di invio fino al completamento dell'operazione di comunicazione.

  • count
    Numero di elementi nella matrice di buffer. Se count è zero, la parte dei dati del messaggio è vuota.

  • datatype
    Handle che rappresenta il tipo di dati degli elementi nel buffer.

  • Dest
    Classificazione del processo di destinazione all'interno del parametro communicator comm .

  • tag
    Tag del messaggio utilizzato per distinguere tipi diversi di messaggi.

  • Comm
    Handle per il comunicatore.

  • richiesta [out]
    In caso di restituzione, un puntatore a un handle che rappresenta l'operazione di comunicazione.

Valore restituito

Restituisce MPI_SUCCESS in caso di esito positivo. In caso contrario, il valore restituito è un codice di errore.

In Fortran il valore restituito viene archiviato nel parametro IERROR .

Fortran

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

Commenti

Questa funzione può restituire prima che il messaggio sia stato copiato dal buffer di invio. Questa funzione è locale, restituisce immediatamente, indipendentemente dallo stato di altri processi. Vedere le osservazioni per la funzione MPI_Rsend per la descrizione della modalità di comunicazione pronta.

Requisiti

Prodotto

Pacchetto ridistribuibile DI HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o utilità client HPC Pack 2008

Intestazione

Mpi.h; Mpif.h

Libreria

Msmpi.lib

DLL

Msmpi.dll

Vedi anche

Funzioni da punto a punto MPI

MPI_Rsend

MPI_Recv

MPI_Irecv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype