MPI_Waitany函式
完成數個未完成作業的其中一項。
語法
int MPIAPI MPI_Waitany(
int count,
_Inout_count_(count) MPI_Request *array_of_requests,
_Out_ int *index,
_Out_ MPI_Status *status
);
參數
計數
array_of_requests參數中的專案數。array_of_requests
MPI_Request未處理作業控制碼的陣列。index [out]
整數的指標，表示已完成之作業 之array_of_requests 參數中的索引。 陣列會從 C 中的零編制索引，以及從 Fortran 中的一個編制索引。狀態 [out]
描述已完成作業 之MPI_Status 物件的指標。
傳回值
傳回成功時 MPI_SUCCESS 。 否則，傳回值是錯誤碼。
在 Fortran 中，傳回值會儲存在 IERROR 參數中。
Fortran
MPI_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR
備註
此函式是非本機作業。 成功完成可能取決於其他進程的比對作業。
當 array_of_requests 參數中的其中一個與作用中要求相關聯的作業完成時，此函式會傳回 。 如果已完成一個以上的未完成作業，則會任意選擇一個。 如果已完成的作業是持續性通訊作業，則持續性要求會標示為非使用中。 解除配置非持續性作業，且其 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 |