MPI_Comm_create_keyval, funkcja

Tworzy nowy klucz atrybutu.

Składnia

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

Parametry

• comm_copy_attr_fn [in, opcjonalnie]
  Kopiuj funkcję wywołania zwrotnego dla klucza.

• comm_delete_attr_fn [in, opcjonalnie]
  Usuń funkcję wywołania zwrotnego dla klucza.

• comm_keyval [out]
  Wartość klucza dla przyszłego dostępu.

• extra_state [in, opcjonalnie]
  Dodatkowy stan funkcji wywołania zwrotnego.

Wartość zwracana

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

Uwagi

Kluczowe wartości są globalne (dostępne dla wszystkich komunikatorów i komunikatorów).

Dostępne są domyślne funkcje kopiowania i usuwania. Są to MPI_COMM_NULL_COPY_FN — funkcja empty copy MPI_COMM_NULL_DELETE_FN — funkcja empty delete MPI_COMM_DUP_FN — prosta funkcja dup

Istnieją subtelne różnice między językami C i Fortran, które wymagają, aby copy_fn były pisane w tym samym języku, z którego MPI_Comm_create_keyval jest wywoływana. Nie powinno to być problemem dla większości użytkowników. tylko programy używające zarówno Fortran, jak i C w tym samym programie muszą mieć pewność, że przestrzegają tej reguły.

Wymagania

Produkt	Pakiet redystrybucyjny PROGRAMU HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny PAKIETU HPC Pack 2008 MS-MPI lub narzędzia klienckie PAKIETU HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

Funkcje buforowania MPI

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function