Metodo IWDFDeviceInitialize::SetFilter (wudfddi.h)

Articolo
03/05/2024

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

Un driver chiama in genere SetFilter dal metodo IDriverEntry::OnDeviceAdd .

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

Vedi anche

IWDFDeviceInitialize

IWDFDriver::CreateDevice