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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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 ermöglicht.
Syntax
void SetFilter();
Rückgabewert
Nichts
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, verwenden Sie das Framework:
- Sendet E/A-Anforderungen, für die der Filter keinen Rückruf an den nächsten logischen Treiber im Stapel registriert hat. Beispielsweise stellt Ihr Filtertreiber eine IQueueCallbackDeviceIoControl::OnDeviceIoControl--Methode bereit, aber nicht IQueueCallbackRead::OnRead oder IQueueCallbackWrite::OnWrite. Daher empfängt Ihr Filtertreiber nur Geräte-E/A-Steuerungsanforderungen.
- Leitet Dateierstellungs-, Bereinigungs- und Schließanforderungen automatisch weiter, sodass Ihr Treiber die IWDFDeviceInitialize::AutoForwardCreateCleanupClose-Methode nicht aufrufen muss.
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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |