Fungsi KsFilterRegisterPowerCallbacks (ks.h)
Fungsi KsFilterRegisterPowerCallbacks mendaftarkan panggilan balik manajemen daya untuk Filter.
Sintaks
void KsFilterRegisterPowerCallbacks(
[in] PKSFILTER Filter,
[in, optional] PFNKSFILTERPOWER Sleep,
[in, optional] PFNKSFILTERPOWER Wake
);
Parameter
[in] Filter
Penunjuk ke struktur KSFILTER untuk mendaftarkan panggilan balik daya. Untuk menerima pesan pemberitahuan daya, Filter harus ber sentris filter.
[in, optional] Sleep
Penunjuk ke fungsi yang menangani permintaan tidur untuk perangkat. Jika NULL, tidak ada panggilan balik tidur yang terdaftar. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.
[in, optional] Wake
Penunjuk ke fungsi yang menangani permintaan bangun untuk perangkat. Jika NULL, tidak ada panggilan balik bangun yang ditentukan. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.
Nilai kembali
Tidak ada
Keterangan
Peringatan
Jangan mencoba untuk mendapatkan mutex kontrol filter* dari dalam panggilan balik Tidur atau Bangun, atau kebuntuan dapat terjadi. Untuk informasi selengkapnya tentang mutex, baca Mutex di AVStream.
Dua panggilan balik harus diprototi sebagai berikut:
void Sleep/Wake (IN PKSFILTER Filter, IN DEVICE_POWER_STATE State);
Panggilan balik Tidur dilakukan jika Filter adalah filter yang ber sentris filter dan perangkat akan tidur. Panggilan balik Bangun dilakukan jika Filter adalah filter yang ber sentris filter dan perangkat bangun.
Untuk informasi tentang status daya perangkat, lihat Status Daya Perangkat.
Lihat juga Menginisialisasi AVStream Minidriver dan Pemrosesan Filter-Sentris.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru dan DirectX 8.0 dan versi DirectX yang lebih baru. |
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |
| IRQL | PASSIVE_LEVEL |