共用方式為


MPI_Test 函式

測試未完成的作業。

語法

int MPIAPI MPI_Test(
  _Inout_  MPI_Request *request,
  _Out_   int          *flag,
  _Out_   MPI_Status   *status
);

參數

  • 要求 [in, out]
    未處理作業 之MPI_Request 控制碼的指標。

  • 旗標 [out]
    傳回時,包含整數的指標,指出要求是否已完成。 非零值表示要求已完成。

  • 狀態 [out]
    傳回時,會包含 MPI_Status 物件的指標,此物件會在完成時描述指定的作業。

傳回值

傳回成功時 MPI_SUCCESS 。 否則,傳回值是錯誤碼。

在 Fortran 中,傳回值會儲存在 IERROR 參數中。

Fortran

    MPI_WAIT(REQUEST, FLAG, STATUS, IERROR)
        LOGICAL FLAG
        INTEGER REQUEST, STATUS(MPI_STATUS_SIZE), IERROR

備註

此函式是本機作業。 成功完成不會相依于其他進程的任何作業。

如果與此要求相關聯的作業是持續性通訊作業,則持續性要求會標示為非使用中。 其他作業會解除配置,而要求控制碼會設定為 MPI_REQUEST_Null

如果 要求 參數指向 MPI_REQUEST_Null 值或非作用中的持續性要求,則函式會傳回 旗標 參數設定為非零值,且 狀態 參數為空白。

規格需求

產品

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 點對點函式

MPI_Wait

MPI_Status

MPI_Testany

MPI_Testall

MPI_Testsome