MSMPI_Queuelock_acquire-Funktion

Ruft die globale Sperre der Microsoft MPI-Bibliothek ab. Die Sperrwarteschlange ist eine FIFO-Warteschlange (First-In-First-Out).

Syntax

void MSMPI_Queuelock_acquire(
  _Out_ MSMPI_Lock_queue *queue
);

Parameter

• Warteschlange [out]
  Zeigt auf eine vom Benutzer bereitgestellte MSMPI_Lock_queue-Struktur , die die Position des aufrufenden Threads in der Warteschlange darstellt, bis der Benutzer die Sperre mithilfe der MSMPI_Queuelock_release-Funktion löst.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Das Verhalten dieser Funktion hängt von der Ebene der Threadunterstützung ab, die verwendet wird. Wenn die Threadunterstützung MPI_THREAD_SERIALIZED oder niedriger ist, ruft diese Funktion die globale Microsoft MPI-Sperre ab, die die FIFO-Serialisierung von Aufrufern ermöglicht und alle MSMPI_Waitsome_interruptible laufenden Funktionsaufrufe unterbricht.

Anwendungen sollten normalerweise die Warteschlangenstruktur auf dem Stapel jedes Mal zuordnen, wenn sie die Sperre erhalten.

Um Fehler zu vermeiden, wenn Threads MSMPI_Waitsome_interruptible in Multithreadanwendungen verwenden, müssen alle Threads die globale Sperre erwerben, bevor sie MPI-Funktionen aufrufen.

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_release

MSMPI_Waitsome_interruptible