funzione MPI_Rget

Operazione di recupero RMA basata su richiesta.

Sintassi

int MPIAPI MPI_Rget(
  _Out_ void         *origin_addr,
        int          origin_count,
        MPI_Datatype origin_datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        int          target_count,
        MPI_Datatype datatype,
        MPI_Win      win,
  _Out_ MPI_Request  *request
);

Parametri

• origin_addr [out]
  Indirizzo del buffer in cui ricevere i dati.

• origin_count
  Numero di voci nel buffer di origine.

• origin_datatype
  Tipo di dati di ogni voce nel buffer di origine.

• target_rank
  Classificazione della destinazione.

• target_disp
  Lo spostamento dalla finestra inizia all'inizio del buffer di destinazione.

• target_count
  Numero di voci nel buffer di destinazione.

• datatype
  Tipo di dati di ogni voce nel buffer di destinazione.

• Vincere
  Oggetto Window utilizzato per la comunicazione.

• richiesta [out]
  Richiesta RMA.

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_RGET(ORIGIN_ADDR, ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK,
                TARGET_DISP, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR)
        <type> ORIGIN_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR

Commenti

MPI_Rget è simile a MPI_Get, ad eccezione del fatto che alloca un oggetto richiesta di comunicazione e lo associa all'handle di richiesta (la richiesta di argomento) che può essere usato per attendere o testare il completamento. Il completamento di un'operazione di MPI_Rget indica che i dati sono disponibili nel buffer di origine. Se origin_addr punta alla memoria collegata a una finestra, i dati diventano disponibili nella copia privata di questa finestra.

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 di comunicazione mpi One-Sided