Condividi tramite


funzione MPI_Irecv

Avvia un'operazione di ricezione e restituisce un handle all'operazione di comunicazione richiesta.

Sintassi

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

Parametri

  • buf [in, facoltativo]
    Puntatore al buffer che contiene i dati da inviare.

  • count
    Numero di elementi nella matrice di buffer. Se la parte dati del messaggio è vuota, impostare il parametro count su 0.

  • datatype
    Tipo di dati degli elementi nel buffer.

  • source
    Classificazione del processo di invio all'interno del comunicatore specificato. Specificare la costante MPI_ANY_SOURCE per specificare che qualsiasi origine sia accettabile.

  • tag
    Tag del messaggio che può essere usato per distinguere tipi diversi di messaggi. Specificare la costante MPI_ANY_TAG per indicare che qualsiasi tag è accettabile.

  • Comm
    Handle per il comunicatore.

  • richiesta [out]
    In caso di restituzione, contiene un handle per l'operazione di comunicazione richiesta.

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

Commenti

Questa funzione è locale, restituisce immediatamente e non attende alcun altro processo. Questa funzione può restituire prima che il messaggio venga ricevuto nel buffer.

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_Send

MPI_Recv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype