MPI_Waitall-Funktion

Schließt mehrere ausstehende Vorgänge ab.

Syntax

int MPIAPI MPI_Waitall(
   int                              count,
   _Inout_count_(count) MPI_Request *array_of_requests,
   _Out_cap_(count) MPI_Status      *array_of_statuses
);

Parameter

• count
  Die Anzahl der Einträge im parameter array_of_requests .

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

• array_of_statuses
  Ein Array von MPI_Status-Objekten , die die abgeschlossenen Vorgänge beschreiben. Es kann MPI_STATUSES_IGNORE werden, wenn keine status Informationen angefordert werden.

Rückgabewert

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

Gibt MPI_ERR_IN_STATUS zurück, wenn ein oder mehrere Vorgänge fehlerhaft abgeschlossen wurden. Die status fehlgeschlagener Vorgänge wird im entsprechenden Eintrag im parameter array_of_statuses zurückgegeben.

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

Fortran

    MPI_WAITALL(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
        INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR

Hinweise

Diese Funktion ist ein nicht lokaler Vorgang. Der erfolgreiche Abschluss hängt möglicherweise von Abgleichsvorgängen in anderen Prozessen ab.

Ein Aufruf von MPI_Waitall wird zurückgegeben, wenn alle Vorgänge abgeschlossen sind, die aktiven Anforderungen im array_of_requests Array zugeordnet sind. Alle Einträge, die persistenten Kommunikationsvorgängen zugeordnet sind, führen dazu, dass die persistente Anforderung als inaktiv markiert wird. Andere Vorgänge werden zugeordnet, und die entsprechenden Einträge in array_of_requests werden auf MPI_REQUEST_NULL festgelegt.

Einträge im array_of_requests-Parameter können MPI_REQUEST_NULL oder ein Handle für eine inaktive persistente Kommunikationsanforderung sein. Wenn der Count-Parameter 0 ist oder alle Einträge in array_of_requestsMPI_REQUEST_NULL oder inaktive persistente Kommunikationsanforderungen sind, wird die Funktion sofort zurückgegeben, wobei der Indexparameter auf MPI_UNDEFINED und eine leere status festgelegt ist.

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

MPI_Testall

MPI_Wait

MPI_Waitany

MPI_Waitsome

MPI_Status