Fungsi WdfTimerStop (wdftimer.h)

Artikel
02/27/2024

[Berlaku untuk KMDF dan UMDF]

Metode WdfTimerStop menghentikan jam timer.

Sintaks

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 yang ditangguhkan (DPC) driver, termasuk fungsi panggilan balik EvtTimerFunc driver, telah dijalankan.

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

Nilai kembali

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

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

Keterangan

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 TungguTRUE. 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.

Contoh

Contoh kode berikut menghentikan timer yang ditentukan dan menunggu semua DPC yang diantrekan driver untuk dijalankan.

WdfTimerStop(
             timerHandle,
             TRUE
             );

Persyaratan

Persyaratan	Nilai
Target Platform	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

WdfTimerCreate

WdfTimerStart

Bagikan melalui