MPI_Test, funkcja

Sprawdza zaległą operację na potrzeby ukończenia.

Składnia

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

Parametry

• żądanie [in, out]
  Wskaźnik do MPI_Request uchwytu zaległej operacji.

• flaga [out]
  Po powrocie zawiera wskaźnik do liczby całkowitej, która wskazuje, czy żądanie zostało ukończone. Wartość niezerowa wskazuje, że żądanie zostało ukończone.

• status [out]
  Po powrocie zawiera wskaźnik do obiektu MPI_Status opisującego określoną operację, jeśli zostanie ukończona.

Wartość zwracana

Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze IERROR .

Fortran

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

Uwagi

Ta funkcja jest operacją lokalną. Pomyślne ukończenie nie zależy od żadnych operacji w innych procesach.

Jeśli operacja skojarzona z tym żądaniem była trwałą operacją komunikacji, żądanie trwałe jest oznaczone jako nieaktywne. Inne operacje są cofane, a obsługa żądań jest ustawiona na MPI_REQUEST_NULL.

Jeśli parametr żądania wskazuje wartość MPI_REQUEST_NULL lub nieaktywne żądanie trwałe, funkcja zwraca parametr z flagą ustawioną na wartość niezerową i z pustym parametrem stanu .

Wymagania

Produkt	Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

Funkcje punkt-punkt MPI

MPI_Wait

MPI_Status

MPI_Testany

MPI_Testall

MPI_Testsome