MSMPI_Waitsome_interruptible-Funktion

Wartet, bis mindestens einer der Vorgänge abgeschlossen ist, die aktiven Handles in der Liste zugeordnet sind, oder bis der Aufruf von einem anderen Thread unterbrochen wird, der MSMPI_Queuelock_acquire aufruft.

Syntax

int MPIAPI MSMPI_Waitsome_interruptible(
        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) int array_of_statuses[]
);

Parameter

• Incount
  Die Anzahl der Anforderungen im Array array_of_requests.

• array_of_requests
  Array von Anforderungshandles der Vorgänge, für die auf die Fertigstellung gewartet werden soll. Wenn ein Anforderungshandle von einer Nichtblockierungskommunikationsfunktion zugewiesen wurde, wird es zugeordnet, und das zugeordnete Handle ist auf MPI_REQUEST_NULL festgelegt.

• Outcount [out]
  Die Anzahl von Anforderungen, die im array_of_requests-Parameter angegeben sind, die abgeschlossen sind, und die Anzahl der Elemente in den array_of_indices - und array_of_statuses-Arrays .

  Wenn die array_of_requests keine aktiven Handles enthält, wird die Funktion sofort zurückgegeben, wobei der Outcount-Parameter auf MPI_UNDEFINED festgelegt ist.

  Wenn diese Funktion unterbrochen wird, bevor Anforderungen abgeschlossen werden, wird der Aufruf zurückgegeben, wobei der Outcount-Parameter auf 0 festgelegt ist.

• array_of_indices
  Gibt die Indizes innerhalb des array_of_requests-Parameters der abgeschlossenen Vorgänge zurück. Arrayindizes sind nullbasiert in C und einsbasiert in Fortran.

• array_of_statuses
  Gibt den status der abgeschlossenen Vorgänge zurück. Die Elemente dieses Arrays entsprechen den Elementen des array_of_indices Arrays.

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.

Wenn die Funktion einen anderen Fehler als MPI_ERR_IN_STATUS zurückgibt, werden die Fehlerfelder der Statuswerte im parameter array_of_statuses nicht aktualisiert.

Hinweise

In einer Multithreadumgebung müssen Benutzer die globale Microsoft MPI-Sperre mithilfe der MSMPI_Queuelock_acquire-Funktion abrufen, bevor sie MSMPI_Waitsome_interruptible aufrufen. Diese Funktion wird unterbrochen, wenn ein anderer Thread die funktion MSMPI_Queuelock_acquire aufruft, um auf die MPI-Bibliothek zuzugreifen.

Diese Funktion ist eine Erweiterung des Standards.

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
Bibliothek	Msmpi.lib
DLL	Msmpi.dll

Weitere Informationen

MPI-Punkt-zu-Punkt-Funktionen

MSMPI_Lock_queue

MSMPI_Queuelock_acquire

MSMPI_Queuelock_release

MPI_Waitsome