다음을 통해 공유


MPI_Comm_create_keyval 함수

새 특성 키를 만듭니다.

구문

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

매개 변수

  • comm_copy_attr_fn [in, optional]
    keyval에 대한 콜백 함수를 복사합니다.

  • comm_delete_attr_fn [in, optional]
    keyval에 대한 콜백 함수를 삭제합니다.

  • comm_keyval [out]
    향후 액세스를 위한 키 값입니다.

  • extra_state [in, optional]
    콜백 함수에 대한 추가 상태입니다.

반환 값

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

설명

키 값은 전역 값입니다(모든 통신자에 사용할 수 있음).

기본 복사 및 삭제 함수를 사용할 수 있습니다. 다음은 MPI_COMM_NULL_COPY_FN - 빈 복사 함수 MPI_COMM_NULL_DELETE_FN - 빈 삭제 함수 MPI_COMM_DUP_FN - 간단한 dup 함수입니다.

C와 Fortran 간에는 copy_fn MPI_Comm_create_keyval 호출되는 동일한 언어로 작성해야 하는 미묘한 차이가 있습니다. 대부분의 사용자에게는 문제가 되지 않습니다. 동일한 프로그램에서 Fortran과 C를 모두 사용하는 프로그래밍 프로그램만 이 규칙을 따르는지 확인해야 합니다.

요구 사항

제품

HPC Pack 2012 MS-MPI 재배포 가능 패키지, HPC Pack 2008 R2 MS-MPI 재배포 가능 패키지, HPC Pack 2008 MS-MPI 재배포 가능 패키지 또는 HPC Pack 2008 클라이언트 유틸리티

헤더

Mpi.h; Mpif.h

라이브러리

Msmpi.lib

DLL

Msmpi.dll

추가 정보

MPI 캐싱 함수

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function