MPI_Register_datarep 函数

注册一组用户提供的数据转换函数。

语法

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

参数

• datarep [in]
  数据表示标识符。

• read_conversion_fn [in， 可选]
  调用的函数从文件表示形式转换为本机表示形式。

• write_conversion_fn [in， 可选]
  调用的函数从本机表示形式转换为文件表示形式。

• dtype_file_extent_fn [in]
  调用的函数以获取文件中表示的数据类型的范围。

• extra_state [in， 可选]
  传递给转换函数的额外状态。

返回值

返回成功 时MPI_SUCCESS 。 否则，返回值为错误代码。

在 Fortran 中，返回值存储在 IERROR 参数中。

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

要求

另请参阅

MPI 文件函数

MPI_Datarep_conversion_function

MPI_Datarep_extent_function