CriticalSection-Klasse

Stellt ein kritisches Abschnittsobjekt dar.

Syntax

class CriticalSection;

Member

Konstruktor

Name	Beschreibung
CriticalSection::CriticalSection	Initialisiert ein Synchronisierungsobjekt, das einem Mutex-Objekt ähnelt, kann jedoch nur von den Threads eines einzelnen Prozesses verwendet werden.
CriticalSection::~CriticalSection	Deinitialisiert und zerstört das aktuelle CriticalSection Objekt.

Öffentliche Methoden

Name	Beschreibung
CriticalSection::IsValid	Gibt an, ob der aktuelle kritische Abschnitt gültig ist.
CriticalSection::Lock	Wartet auf den Besitz des angegebenen kritischen Abschnittsobjekts. Die Funktion gibt zurück, wenn dem aufrufenden Thread der Besitz gewährt wird.
CriticalSection::TryLock	Versucht, einen kritischen Abschnitt ohne Blockierung einzugeben. Wenn der Aufruf erfolgreich ist, übernimmt der aufrufende Thread den Besitz des kritischen Abschnitts.

Geschützte Datenmember

Name	Beschreibung
CriticalSection::cs_	Deklariert ein kritisches Abschnittsdatenelement.

Vererbungshierarchie

CriticalSection

Anforderungen

Kopfzeile: corewrappers.h

Namespace: Microsoft::WRL::Wrapper

CriticalSection::~CriticalSection

Deinitialisiert und zerstört das aktuelle CriticalSection Objekt.

WRL_NOTHROW ~CriticalSection();

CriticalSection::CriticalSection

Initialisiert ein Synchronisierungsobjekt, das einem Mutex-Objekt ähnelt, kann jedoch nur von den Threads eines einzelnen Prozesses verwendet werden.

explicit CriticalSection(
   ULONG spincount = 0
);

Parameter

Spincount
Die Drehzahl für das kritische Abschnittsobjekt. Der Standardwert ist 0.

Hinweise

Weitere Informationen zu kritischen Abschnitten und Spincounts finden Sie in der InitializeCriticalSectionAndSpinCount Funktion im Synchronization Abschnitt der Windows-API-Dokumentation.

CriticalSection::cs_

Deklariert ein kritisches Abschnittsdatenelement.

CRITICAL_SECTION cs_;

Hinweise

Dieses Datenelement ist geschützt.

CriticalSection::IsValid

Gibt an, ob der aktuelle kritische Abschnitt gültig ist.

bool IsValid() const;

Rückgabewert

Gibt standardmäßig immer zurück true.

CriticalSection::Lock

Wartet auf den Besitz des angegebenen kritischen Abschnittsobjekts. Die Funktion gibt zurück, wenn dem aufrufenden Thread der Besitz gewährt wird.

SyncLock Lock();

   static SyncLock Lock(
   _In_ CRITICAL_SECTION* cs
);

Parameter

Cs
Ein vom Benutzer angegebenes kritisches Abschnittsobjekt.

Rückgabewert

Ein Sperrobjekt, das zum Entsperren des aktuellen kritischen Abschnitts verwendet werden kann.

Hinweise

Die erste Lock Funktion wirkt sich auf das aktuelle kritische Abschnittsobjekt aus. Die zweite Lock Funktion wirkt sich auf einen vom Benutzer angegebenen kritischen Abschnitt aus.

CriticalSection::TryLock

Versucht, einen kritischen Abschnitt ohne Blockierung einzugeben. Wenn der Aufruf erfolgreich ist, übernimmt der aufrufende Thread den Besitz des kritischen Abschnitts.

SyncLock TryLock();

static SyncLock TryLock(
   _In_ CRITICAL_SECTION* cs
);

Parameter

Cs
Ein vom Benutzer angegebenes kritisches Abschnittsobjekt.

Rückgabewert

Ein Wert ungleich Null, wenn der kritische Abschnitt erfolgreich eingegeben wird oder der aktuelle Thread bereits den kritischen Abschnitt besitzt. Null, wenn ein anderer Thread bereits den kritischen Abschnitt besitzt.

Hinweise

Die erste TryLock Funktion wirkt sich auf das aktuelle kritische Abschnittsobjekt aus. Die zweite TryLock Funktion wirkt sich auf einen vom Benutzer angegebenen kritischen Abschnitt aus.