Fungsi DbgLockTrace

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine dan Audio/Video Capture di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Mengaktifkan atau menonaktifkan pengelogan debug dari bagian penting tertentu.

Sintaks

void WINAPI DbgLockTrace(
   CCritSec *pcCrit,
   BOOL     fTrace
);

Parameter

pcCrit

Penunjuk ke bagian kritis CCritSec .

fTrace

Nilai yang menentukan apakah pengelogan diaktifkan. Gunakan TRUE untuk mengaktifkan pengelogan atau FALSE untuk menonaktifkannya.

Mengembalikan nilai

Fungsi ini tidak mengembalikan nilai.

Keterangan

Gunakan fungsi ini untuk melacak bagian penting tertentu. Secara default, pengelogan debug bagian penting dinonaktifkan, karena banyaknya bagian penting.

Untuk melacak bagian penting, lakukan langkah-langkah berikut:

1. Tentukan DEBUG atau _DEBUG sebelum Anda menyertakan header DirectShow.
2. Aktifkan pengelogan debug untuk bagian penting, dengan memanggil DbgSetModuleLevel dengan bendera LOG_LOCKING.
3. Panggil DbgLockTrace di bagian penting yang ingin Anda lacak.

Dalam build ritel, fungsi DbgLockTrace tidak berpengaruh.

Contoh

Contoh kode berikut menunjukkan cara melacak bagian penting.

DbgInitialise(g_hInst);
DbgSetModuleLevel(LOG_LOCKING, 3);

{
    CCritSec MyLock;
    DbgLockTrace(&MyLock, TRUE);
    
    CAutoLock cObjectLock(&MyLock);

    // Protected section of code.    
    DbgOutString("This code is inside a critical section.\n");

} // Lock goes out of scope here.

DbgTerminate();

Persyaratan

Lihat juga

Fungsi Penelusuran Kesalahan Bagian Penting