Funzione CritCheckIn

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Restituisce TRUE se il thread corrente è il proprietario della sezione critica specificata.

Sintassi

BOOL WINAPI CritCheckIn(
   CCritSec *pcCrit
);

Parametri

pcCrit: Puntatore a una sezione critica CCritSec .

Valore restituito

Nelle compilazioni di debug restituisce TRUE se il thread corrente è il proprietario di questa sezione critica o FALSE in caso contrario. Nelle compilazioni al dettaglio restituisce sempre TRUE.

Commenti

Questa funzione è particolarmente utile all'interno della macro ASSERT , per verificare se un thread possiede un determinato blocco.

Esempio

Nell'esempio di codice seguente viene illustrato come usare questa funzione:

{
    CCritSec MyLock;  // Critical section is not locked yet.
    
    ASSERT(CritCheckIn(&MyLock)); // This assert will fire.

    // Lock the critical section.    
    CAutoLock cObjectLock(&MyLock);
     
    ASSERT(CritCheckIn(&MyLock)); // This assert will not fire.

} // Lock goes out of scope here.

Requisiti

Requisito	Valore
Intestazione	Wxutil.h (include Streams.h)
Libreria	Strmbase.lib (build al dettaglio); Strmbasd.lib (build di debug)

Vedi anche

Funzioni di debug della sezione critica

Share via