MPI_Cancel函数

取消通信请求。

语法

int MPIAPI MPI_Cancel(
  _In_ MPI_Request *request
);

参数

  • request [in]
    通信请求。

返回值

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

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

Fortran

    MPI_CANCEL(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

注解

MPI_Cancel的主要预期用途是在多缓冲方案中,其中进行推理MPI_Irecv。 计算完成后,其中一些接收请求可能会保留;使用 MPI_Cancel 允许用户取消这些不满意的请求。

取消发送操作要困难得多,这在很大程度上是因为发送通常至少部分完成, (标记、大小和源的信息通常会立即发送到目标) 。 建议用户取消发送,而 MPI 标准) 定义的本地操作 (, (通常会) 生成一条或多条内部消息,这一成本可能很高。

要求

产品

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 点到点函数