MPI_Waitall 函式
完成多個未處理的作業。
語法
int MPIAPI MPI_Waitall(
int count,
_Inout_count_(count) MPI_Request *array_of_requests,
_Out_cap_(count) MPI_Status *array_of_statuses
);
參數
計數
array_of_requests 參數中的項目數。array_of_requests
MPI_Request未處理作業句柄的陣列。array_of_statuses
描述已完成作業 的 MPI_Status 物件的陣列。 如果未要求任何狀態資訊，則可能MPI_STATUSES_IGNORE。
傳回值
傳回成功時 MPI_SUCCESS 。 否則，傳回值是錯誤碼。
如果發生錯誤，則傳回 MPI_ERR_IN_STATUS 一或多個作業。 失敗作業的狀態會在 array_of_statuses 參數的對應項目中傳回。
在 Fortran 中，傳回值會儲存在 IERROR 參數中。
Fortran
MPI_WAITALL(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR
備註
此函式是非本機作業，成功完成可能取決於其他進程的比對作業。
當array_of_requests陣列中與作用中要求相關聯的所有作業完成時，MPI_Waitall呼叫就會傳回。 與永續性通訊作業相關聯的任何專案，都會將持續性要求標示為非使用中。 其他作業會解除分配，且 array_of_requests中的對應 項目會設定為 MPI_REQUEST_NULL。
array_of_requests 參數中的專案可以MPI_REQUEST_NULL或非作用中持續通訊要求的句柄。 如果 count 參數為零，或 array_of_requests 中的所有專案 都MPI_REQUEST_NULL 或非作用中的持續性通訊要求，則函式會立即傳回 索引 參數設定為 MPI_UNDEFINED 和空白狀態。
規格需求
產品 |
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 |