Fungsi WdfTimerStop (wdftimer.h)

Artikel
11/08/2024

[Berlaku untuk KMDF dan UMDF]

Metode WdfTimerStop menghentikan jam timer.

Sintaksis

BOOLEAN WdfTimerStop(
  [in] WDFTIMER Timer,
  [in] BOOLEAN  Wait
);

Parameter

[in] Timer

Handel ke objek pengatur waktu kerangka kerja yang diperoleh dengan memanggil WdfTimerCreate.

[in] Wait

KMDF nilai Boolean yang, jika TRUE, menentukan bahwa kerangka kerja tidak kembali sampai semua panggilan antrean ke panggilan prosedur (DPC) yang ditangguhkan driver, termasuk fungsi panggilan balik EvtTimerFunc driver, telah dijalankan.

UMDF nilai Boolean yang, jika TRUE, menentukan bahwa kerangka kerja tidak kembali sampai semua panggilan antrean ke fungsi panggilan balik EvtTimerFunc timer telah dijalankan.

Mengembalikan nilai

WdfTimerStop mengembalikan TRUE jika objek timer berada dalam antrean timer sistem. Jika tidak, metode ini mengembalikan FALSE. Untuk informasi selengkapnya, lihat bagian Komentar berikut ini.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Komentar

Ketika driver memanggil WdfTimerStart, objek timer-nya ditambahkan ke antrean objek timer sistem. Jika timer bukan timer berkala, sistem akan menghapus objek timer dari antrean setelah "waktu jatuh tempo" timer berlalu. Jika timer adalah timer berkala, objek timer tetap dalam antrean hingga driver memanggil WdfTimerStop.

Untuk informasi selengkapnya tentang objek timer kerangka kerja, lihat Menggunakan Timer.

WdfTimerStop harus dipanggil di IRQL = PASSIVE_LEVEL jika parameter Tunggu TRUE. Jika tidak, metode ini harus dipanggil di IRQL <= DISPATCH_LEVEL.

Jangan panggil WdfTimerStop dari dalam EvtTimerFunc dengan parameter Tunggu diatur ke TRUE. Melakukannya dapat mengakibatkan kebuntuan.

Hati

Panggilan bersamaan ke WdfTimerStop pada objek timer yang sama akan masuk ke debugger jika Verifier diaktifkan. Untuk informasi selengkapnya, lihat MenggunakanPemverifikasi KMDF .

Contoh

Contoh kode berikut menghentikan timer tertentu dan menunggu semua DPC antrean driver dijalankan.

WdfTimerStop(
             timerHandle,
             TRUE
             );

Persyaratan

Syarat	Nilai
Platform Target	Universal
versi KMDF Minimum	1.0
versi UMDF Minimum	2.0
Header	wdftimer.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	Lihat bagian Keterangan.
aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

EvtTimerFunc

WdfTimerBuat

WdfTimerStart

Bagikan melalui