Compartilhar via

função MPI_Comm_free_keyval

  • Artigo

Libera uma chave de atributo extant.

Sintaxe

int MPIAPI MPI_Comm_free_keyval(
   _Inout_ int *comm_keyval
);

Parâmetros

  • comm_keyval
    Valor da chave.

Retornar valor

Retorna MPI_SUCCESS com êxito. Caso contrário, o valor retornado será um código de erro.

No Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

    MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
        INTEGER COMM_KEYVAL, IERROR

Comentários

Essa função define o valor de keyval como MPI_KEYVAL_INVALID. Observe que não é errado liberar uma chave de atributo que está em uso, pois a liberação real não ocorre até que todas as referências (em outros comunicadores no processo) para a chave tenham sido liberadas. Essas referências precisam ser explictly liberadas pelo programa, seja por meio de chamadas para MPI_Comm_delete_attr que liberam uma instância de atributo ou por chamadas para MPI_Comm_free que liberam todas as instâncias de atributo associadas ao comunicador liberado.

Requisitos

Produto

Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008

parâmetro

 Mpi.h; Mpif.h

Biblioteca

 Msmpi.lib

DLL

 Msmpi.dll

Confira também

Funções de cache de MPI