Função MPI_Comm_create_keyval

Cria uma nova chave de atributo.

Sintaxe

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 a função de retorno de chamada para keyval.

• comm_delete_attr_fn [in, opcional]
  Exclua a função de retorno de chamada para keyval.

• comm_keyval [out]
  Valor de chave para acesso futuro.

• extra_state [in, opcional]
  Estado extra para funções de retorno de chamada.

Retornar valor

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

Comentários

Os valores de chave são globais (disponíveis para todo e qualquer comunicador).

As funções padrão de cópia e exclusão estão disponíveis. Eles são MPI_COMM_NULL_COPY_FN - função de cópia vazia MPI_COMM_NULL_DELETE_FN - função de exclusão vazia MPI_COMM_DUP_FN - função dup simples

Há diferenças sutis entre C e Fortran que exigem que o copy_fn seja escrito na mesma linguagem da qual MPI_Comm_create_keyval é chamado. Isso não deve ser um problema para a maioria dos usuários; somente os programadores que usam Fortran e C no mesmo programa precisam ter certeza de que seguem essa regra.

Requisitos

Confira também

Funções de cache de MPI

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function