共用方式為


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_initMPI_Send_init 和朋友建立的非作用中持續性要求。 也允許釋放作用中的要求。 不過,一旦釋放,要求就無法再用於等候或測試常式 (,例如 MPI_Wait) 來判斷完成。

此常式也可以用來釋放非持續性要求,例如使用 MPI_IrecvMPI_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

另請參閱

MPI 點對點函式