Partager via


MPI_Comm_create_keyval fonction

Crée une clé d’attribut.

Syntaxe

int MPIAPI MPI_Comm_create_keyval(
  _In_opt_ MPI_Comm_copy_attr_function   *comm_copy_attr_fn,
  _In_opt_ MPI_Comm_delete_attr_function *comm_delete_attr_fn,
  _Out_    int                           *comm_keyval,
  _In_opt_ void                          *extra_state
);

Paramètres

  • comm_copy_attr_fn [in, facultatif]
    Copier la fonction de rappel pour keyval.

  • comm_delete_attr_fn [in, facultatif]
    Supprimer la fonction de rappel pour keyval.

  • comm_keyval [out]
    Valeur de clé pour un accès futur.

  • extra_state [in, facultatif]
    État supplémentaire pour les fonctions de rappel.

Valeur retournée

MPI_SUCCESS

Fortran

    MPI_COMM_CREATE_KEYVAL(COMM_COPY_ATTR_FN, COMM_DELETE_ATTR_FN, COMM_KEYVAL,
            EXTRA_STATE, IERROR)
        EXTERNAL COMM_COPY_ATTR_FN, COMM_DELETE_ATTR_FN
        INTEGER COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE

Remarques

Les valeurs de clé sont globales (disponibles pour tous les communicateurs).

Les fonctions de copie et de suppression par défaut sont disponibles. Il s’agit de MPI_COMM_NULL_COPY_FN - fonction de copie vide MPI_COMM_NULL_DELETE_FN - fonction de suppression vide MPI_COMM_DUP_FN - fonction dup simple

Il existe des différences subtiles entre C et Fortran qui nécessitent que le copy_fn être écrit dans la même langue à partir de laquelle MPI_Comm_create_keyval est appelé. Cela ne devrait pas être un problème pour la plupart des utilisateurs ; seuls les programmateurs qui utilisent Fortran et C dans le même programme doivent s’assurer qu’ils respectent cette règle.

Configuration requise

Produit

HpC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities

En-tête

Mpi.h ; Mpif.h

Bibliothèque

Msmpi.lib

DLL

Msmpi.dll

Voir aussi

Fonctions de mise en cache MPI

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function