MPI_Testsome-Funktion

Tests für einige der angegebenen Anforderungen müssen abgeschlossen werden.

Syntax

int MPIAPI MPI_Testsome(
        int                                                incount,
        _Inout_count_(incount) MPI_Request                 *array_of_requests,
  _Out_ int                                                *outcount,
        _Out_cap_post_count_(incount,*outcount) int        *array_of_indices,
        _Out_cap_post_count_(incount,*outcount) MPI_Status *array_of_statuses
);

Parameter

• incount
  Die Anzahl der Einträge in array_of_requests Parameter.

• array_of_requests
  Ein Array von MPI_Request Handles ausstehender Vorgänge.

• outcount [out]
  Die Anzahl der abgeschlossenen Anforderungen.

• array_of_indices
  Array von Indizes im array_of_requests abgeschlossener Vorgänge. Die array_of_requests wird von null in C und von 1 in Fortran indiziert.

• array_of_statuses
  Array von status-Objekten für abgeschlossene Vorgänge oder MPI_STATUSES_IGNORE.

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

    MPI_TESTSOME(INCOUNT, ARRAY_OF_REQUESTS, OUTCOUNT, ARRAY_OF_INDICES, ARRAY_OF_STATUSES, IERROR)
        INTEGER INCOUNT, ARRAY_OF_REQUESTS(*), OUTCOUNT, ARRAY_OF_INDICES(*),
        ARRAY_OF_STATUSES(MPI_STATUS_SIZE,*), IERROR

Hinweise

Obwohl es möglich ist, ein Anforderungshandle mehrmals im array_of_requests auflisten, wird eine solche Aktion als fehlerhaft angesehen und kann dazu führen, dass das Programm nicht ausgeführt wird oder zu falschen Ergebnissen führt.

Anforderungen

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliothek	Msmpi.lib
DLL	Msmpi.dll

Weitere Informationen

MPI-Punkt-zu-Punkt-Funktionen