MPI_Win_create_keyval function

Article
09/14/2018

Creates an attribute keyval for MPI window objects.

Syntax

int MPIAPI MPI_Win_create_keyval(
  _In_     MPI_Win_copy_attr_function   *win_copy_attr_fn,
  _In_     MPI_Win_delete_attr_function *win_delete_attr_fn,
  _Out_    int                          *win_keyval,
  _In_opt_ void                         *extra_state
);

Parameters

win_copy_attr_fn [in]
Copy callback function for win_keyval.
win_delete_attr_fn [in]
Delete callback function for win_keyval.
win_keyval [out]
Key value for future access.
extra_state [in, optional]
Extra state for callback functions.

Return value

Returns MPI_SUCCESS on success. Otherwise, the return value is an error code.

In Fortran, the return value is stored in the IERROR parameter.

Fortran

    MPI_WIN_CREATE_KEYVAL(WIN_COPY_ATTR_FN, WIN_DELETE_ATTR_FN, WIN_KEYVAL,
                EXTRA_STATE, IERROR)
        EXTERNAL WIN_COPY_ATTR_FN, WIN_DELETE_ATTR_FN
        INTEGER WIN_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE

Remarks

Default copy and delete functions are available. These are

MPI_WIN_NULL_COPY_FN - empty copy function
MPI_WIN_NULL_DELETE_FN - empty delete function
MPI_WIN_DUP_FN - simple dup function

Requirements

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package or HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Library	Msmpi.lib
DLL	Msmpi.dll

Share via