função MPI_Comm_create_keyval

Artigo
12/27/2023

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]
Copiar a função de chamada de retorno para keyval.
comm_delete_attr_fn [in, opcional]
Eliminar a função de chamada de retorno para keyval.
comm_keyval [fora]
Valor de chave para acesso futuro.
extra_state [in, opcional]
Estado extra para funções de chamada de retorno.

Valor devolvido

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

Observações

Os valores-chave são globais (disponíveis para todos e todos os comunicadores).

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

Existem diferenças subtis entre C e Fortran que exigem que o copy_fn seja escrito na mesma linguagem a partir da qual MPI_Comm_create_keyval é chamado. Isto não deve ser um problema para a maioria dos utilizadores; apenas os programadores que utilizam Fortran e C no mesmo programa têm de ter a certeza de que seguem esta regra.

Requisitos

Produto	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
Cabeçalho	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
DLL	Msmpi.dll

Ver também

Funções de Colocação em Cache de MPI

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function

Partilhar via