MPI_Request_free 函数
释放通信请求对象。
语法
int MPIAPI MPI_Request_free(
_Inout_ MPI_Request *request
);
参数
-
请求
通信请求。
返回值
返回成功 时MPI_SUCCESS 。 否则，返回值为错误代码。
在 Fortran 中，返回值存储在 IERROR 参数中。
Fortran
MPI_REQUEST_FREE(REQUEST, IERROR)
INTEGER REQUEST, IERROR
注解
此例程通常用于释放使用 MPI_Recv_init 或 MPI_Send_init 和友元创建的非活动持久请求。 还允许释放活动请求。 但是，释放后，请求不能再用于等待或测试例程 (例如， MPI_Wait) 来确定完成。
此例程还可用于释放非持久性请求，例如使用 MPI_Irecv 或 MPI_Isend 和好友创建的请求。 与活动持久请求一样，一旦释放，请求就不能再用于测试/等待例程来确定完成情况。
要求
产品 |
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 |