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

Siehe auch

IWDFDeviceInitialize

IWDFDriver::CreateDevice