MPI_Cancel函式
取消通訊要求。
語法
int MPIAPI MPI_Cancel(
_In_ MPI_Request *request
);
參數
-
要求 [in]
通訊要求。
傳回值
傳回成功時 MPI_SUCCESS 。 否則，傳回值是錯誤碼。
在 Fortran 中，傳回值會儲存在 IERROR 參數中。
Fortran
MPI_CANCEL(REQUEST, IERROR)
INTEGER REQUEST, IERROR
備註
MPI_Cancel的主要用途是在多重緩衝配置中，其中會進行推測性MPI_Irecv。 計算完成時，可能會保留其中一些接收要求;using 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 |