IWDFDeviceInitialize::SetFilter-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die SetFilter-Methode legt die Eigenschaft fest, die ein Gerät als Filtergerät aktiviert.

Syntax

void SetFilter();

Rückgabewert

Keine

Bemerkungen

Ein Filtertreiber ruft SetFilter auf, um sich selbst als Filter zu markieren. Wenn Sie dem Framework mitteilen, dass Es sich bei Ihrem Treiber um einen Filter handelt, führt das Framework Folgendes aus:

• Sendet E/A-Anforderungen, für die der Filter keinen Rückruf registriert hat, an den nächsten logischen Treiber im Stapel. Der Filtertreiber stellt beispielsweise eine IQueueCallbackDeviceIoControl::OnDeviceIoControl-Methode bereit, aber nicht IQueueCallbackRead::OnRead oder IQueueCallbackWrite::OnWrite. Daher empfängt Ihr Filtertreiber nur Geräte-E/A-Steuerungsanforderungen.
• Leitet Anforderungen zum Erstellen, Bereinigen und Schließen von Dateien automatisch weiter, damit Ihr Treiber die IWDFDeviceInitialize::AutoForwardCreateCleanupClose-Methode nicht aufrufen muss.

Ein Treiber ruft In der Regel SetFilter über seine IDriverEntry::OnDeviceAdd-Methode auf.

Beispiele

Ein Codebeispiel für die Verwendung der SetFilter-Methode finden Sie unter IWDFDriver::CreateDevice.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.5
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFDeviceInitialize

IWDFDriver::CreateDevice