MPI_Win_create function

Creates an MPI Window object for one-sided communication.

Syntax

int MPIAPI MPI_Win_create(
  _In_  void     *base,
        MPI_Aint size,
        int      disp_unit,
        MPI_Info info,
        MPI_Comm comm,
  _Out_ MPI_Win  *win
);

Parameters

• base [in]
  Initial address of the memory window.

• size
  Size of the memory window in bytes.

• disp_unit
  Local unit size for displacements, in bytes.

• info
  Info argument.

• comm
  Communicator.

• win [out]
  Window object returned by the call.

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(BASE, SIZE, DISP_UNIT, INFO, COMM, WIN, IERROR)
        <type> BASE(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) SIZE
        INTEGER DISP_UNIT, INFO, COMM, WIN, IERROR

Remarks

The call is collective on an intracommunicator. MPI_Win_create allows each process to specify a window in its memory that is made accessible to accesses by remote processes. The call returns an opaque object that represents the group of processes that own and access the set of windows, and the attributes of each window, as specified by the initialization call.

Requirements

See also

MPI One-Sided Communications Functions