MPI_Register_datarep function

Register a set of user-provided data conversion functions.

Syntax

int MPIAPI MPI_Register_datarep(
  _In_     char                            *datarep,
  _In_opt_ MPI_Datarep_conversion_function *read_conversion_fn,
  _In_opt_ MPI_Datarep_conversion_function *write_conversion_fn,
  _In_     MPI_Datarep_extent_function     *dtype_file_extent_fn,
  _In_opt_ void                            *extra_state
);

Parameters

  • datarep [in]
    Data representation identifier.

  • read_conversion_fn [in, optional]
    Function invoked to convert from file representation to native representation.

  • write_conversion_fn [in, optional]
    Function invoked to convert from native representation to file representation.

  • dtype_file_extent_fn [in]
    Function invoked to get the extent of a datatype as represented in the file.

  • extra_state [in, optional]
    Extra state that is passed to the conversion 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_REGISTER_DATAREP(DATAREP, READ_CONVERSION_FN, WRITE_CONVERSION_FN,
                DTYPE_FILE_EXTENT_FN, EXTRA_STATE, IERROR)
        CHARACTER*(*) DATAREP
        EXTERNAL READ_CONVERSION_FN, WRITE_CONVERSION_FN, DTYPE_FILE_EXTENT_FN
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE
        INTEGER IERROR

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

See also

MPI File Functions

MPI_Datarep_conversion_function

MPI_Datarep_extent_function