Metodo IWDFDeviceInitialize::SetFilter (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]
Il metodo SetFilter imposta la proprietà che abilita un dispositivo come dispositivo di filtro.
Sintassi
void SetFilter();
Valore restituito
nessuno
Osservazioni
Un driver di filtro chiama SetFilter per contrassegnarsi come filtro. Quando si indica al framework che il driver è un filtro, il framework:
- Invia richieste di I/O per cui il filtro non ha registrato un callback al driver logico successivo nello stack. Ad esempio, il driver di filtro fornisce un metodo IQueueCallbackDeviceIoControl::OnDeviceIoControl , ma non IQueueCallbackRead::OnRead o IQueueCallbackWrite::OnWrite. Di conseguenza, il driver di filtro riceve solo le richieste di controllo di I/O del dispositivo.
- Inoltra automaticamente le richieste di creazione, pulizia e chiusura del file in modo che il driver non debba chiamare il metodo IWDFDeviceInitialize::AutoForwardCreateCleanupClose .
Esempio
Per un esempio di codice su come usare il metodo SetFilter , vedere IWDFDriver::CreateDevice.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.5 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |