Compartir a través de


función MPI_Comm_create_keyval

Crea una nueva clave de atributo.

Sintaxis

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
);

Parámetros

  • comm_copy_attr_fn [in, opcional]
    Copie la función de devolución de llamada para keyval.

  • comm_delete_attr_fn [in, opcional]
    Elimine la función de devolución de llamada para keyval.

  • comm_keyval [out]
    Valor de clave para el acceso futuro.

  • extra_state [in, opcional]
    Estado adicional para las funciones de devolución de llamada.

Valor devuelto

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

Comentarios

Los valores de clave son globales (disponibles para cualquiera y todos los comunicadores).

Las funciones de copia y eliminación predeterminadas están disponibles. Se trata de MPI_COMM_NULL_COPY_FN : función de copia vacía MPI_COMM_NULL_DELETE_FN : función de eliminación vacía MPI_COMM_DUP_FN : función dup simple

Hay diferencias sutiles entre C y Fortran que requieren que se escriba el copy_fn en el mismo lenguaje desde el que se llama a MPI_Comm_create_keyval . Esto no debería ser un problema para la mayoría de los usuarios; solo los programadores que usan Fortran y C en el mismo programa deben asegurarse de que siguen esta regla.

Requisitos

Producto

Paquete redistribuible de HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Client Utilities

Encabezado

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

Archivo DLL

Msmpi.dll

Consulte también

Funciones de almacenamiento en caché de MPI

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function