Delen via


MSMPI_Queuelock_acquire functie

Hiermee verkrijgt u de globale vergrendeling van de Microsoft MPI-bibliotheek. De vergrendelingswachtrij is een FIFO-wachtrij (First-In-First-Out).

Syntaxis

void MSMPI_Queuelock_acquire(
  _Out_ MSMPI_Lock_queue *queue
);

Parameters

  • wachtrij [uit]
    Verwijst naar een door de gebruiker opgegeven MSMPI_Lock_queue structuur die de positie van de aanroepende thread in de wachtrij vertegenwoordigt totdat de gebruiker de vergrendeling loslaat met behulp van de functie MSMPI_Queuelock_release .

Retourwaarde

Deze functie retourneert geen waarde.

Opmerkingen

Het gedrag van deze functie is afhankelijk van het niveau van threadondersteuning dat wordt gebruikt. Wanneer de threadondersteuning MPI_THREAD_SERIALIZED of lager is, verkrijgt deze functie de globale vergrendeling van Microsoft MPI, die FIFO-serialisatie van bellers biedt en alle MSMPI_Waitsome_interruptible functie-aanroepen die worden uitgevoerd, onderbreekt.

Toepassingen moeten normaal gesproken de wachtrijstructuur op de stack toewijzen telkens wanneer ze de vergrendeling verkrijgen.

Om fouten te voorkomen wanneer threads MSMPI_Waitsome_interruptible gebruiken in toepassingen met meerdere threads, moeten alle threads de algemene vergrendeling verkrijgen voordat ze MPI-functies aanroepen.

Deze functie is een uitbreiding op de standaard.

Vereisten

Product

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities

Header

Mpi.h

Bibliotheek

Msmpi.lib

DLL

Msmpi.dll

Zie ook

MPI-punt-naar-puntfuncties

MSMPI_Lock_queue

MSMPI_Queuelock_release

MSMPI_Waitsome_interruptible