Metode IWDFDeviceInitialize::SetFilter (wudfddi.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Metode SetFilter mengatur properti yang memungkinkan perangkat sebagai perangkat filter.
Sintaks
void SetFilter();
Mengembalikan nilai
Tidak ada
Keterangan
Driver filter memanggil SetFilter untuk menandai dirinya sebagai filter. Saat Anda memberi tahu kerangka kerja bahwa driver Anda adalah filter, kerangka kerja:
- Mengirim permintaan I/O yang filternya belum mendaftarkan panggilan balik ke driver logis berikutnya di tumpukan. Misalnya, driver filter Anda menyediakan metode IQueueCallbackDeviceIoControl::OnDeviceIoControl , tetapi bukan metode IQueueCallbackRead::OnRead atau IQueueCallbackWrite::OnWrite. Akibatnya, driver filter Anda hanya menerima permintaan kontrol I/O perangkat.
- Secara otomatis meneruskan permintaan pembuatan, pembersihan, dan penutupan file sehingga driver Anda tidak perlu memanggil metode IWDFDeviceInitialize::AutoForwardCreateCleanupClose .
Contoh
Untuk contoh kode tentang cara menggunakan metode SetFilter , lihat IWDFDriver::CreateDevice.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
| Target Platform | Desktop |
| Versi UMDF minimum | 1,5 |
| Header | wudfddi.h (termasuk Wudfddi.h) |
| DLL | WUDFx.dll |