MPI_Comm_dup functie

Hiermee dupliceert u een bestaande communicator met gekoppelde sleutelwaarden. Voor elke sleutelwaarde bepaalt de respectieve copy callback-functie de kenmerkwaarde die is gekoppeld aan deze sleutel in de nieuwe communicator. De copy callback kan bijvoorbeeld het kenmerk van de nieuwe communicator verwijderen.

Syntaxis

int MPIAPI MPI_Comm_dup(
        MPI_Comm comm,
  _Out_ MPI_Comm *newcomm
);

Parameters

• Comm
  De communicator die moet worden gedupliceerd.

• newcomm [out]
  Bij terugkomst bevat een handvat voor een nieuwe communicator. De nieuwe communicator heeft dezelfde groep of groepen en alle gekopieerde gegevens in de cache van de bron, maar deze bevat nieuwe contextinformatie.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

    MPI_COMM_DUP(COMM,NEWCOMM,IERROR)
        INTEGER COMM, NEWCOMM, IERROR

Opmerkingen

Deze functie maakt een dubbele communicatieruimte met dezelfde eigenschappen als de oorspronkelijke communicator. Dit omvat alle kenmerken en topologieën. Deze functie is ook geldig als er punt-naar-punt-communicatie in behandeling is waarbij de broncommunicator is betrokken.

Een gebruiker kan de functie MPI_Comm_dup aanroepen aan het begin van het parallelle proces en de dubbele communicator later vrijmaken met behulp van de functie MPI_Comm_free . Andere modellen van communicator management zijn ook mogelijk.

Deze functie is van toepassing op zowel intracommunicators als intercommunicators.

Vereisten

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliotheek	Msmpi.lib
DLL	Msmpi.dll

Zie ook

MPI Communicator-functies