IWDFDeviceInitialize::AutoForwardCreateCleanupClose-Methode (wudfddi.h)

Artikel
02/07/2025

[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 AutoForwardCreateCleanupClose Methodensteuerelemente beim Erstellen, Bereinigen und Schließen von Benachrichtigungen werden an den nächsten niedrigeren Treiber im Gerätestapel weitergeleitet.

Syntax

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

Parameter

[in] State

Ein WDF_TRI_STATE typierter Wert, der den Status der automatischen Weiterleitung identifiziert. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
WdfUseDefault- (0)	Das Framework verwendet das Standardweiterleitungsschema. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
WdfFalse- (1)	Das Framework leitet keine Benachrichtigungen zum erstellen, bereinigen und schließen an den nächsten unteren Treiber weiter.
WdfTrue- (2)	Das Framework leitet Benachrichtigungen synchron an den nächsten unteren Treiber weiter, erstellt, bereinigen und schließen.

Rückgabewert

Nichts

Bemerkungen

Wenn der UMDF-Treiber WdfUseDefault für den Parameter State in einem Aufruf von AutoForwardCreateCleanupCloseübergibt, verwendet das Framework ein Standardweiterleitungsschema zum Erstellen, Bereinigen und Schließen von Benachrichtigungen, die davon abhängen, ob der Treiber ein Filter- oder Funktionstreiber ist:

Wenn der Treiber ein Filtertreiber ist, besteht das Standardweiterleitungsschema darin, Benachrichtigungen synchron an den nächsten unteren Treiber weiterzuleiten.
Wenn der Treiber ein Funktionstreiber ist, besteht das Standardweiterleitungsschema nicht darin, Benachrichtigungen an den nächsten unteren Treiber weiterzuleiten.

Wenn das Framework für die Weiterleitung eingerichtet ist, leitet es Bereinigungs- und Schließbenachrichtigungen weiter, unabhängig davon, ob der Treiber die IFileCallbackCleanup::OnCleanupFile und IFileCallbackClose::OnCloseFile Schnittstellenmethoden unterstützt. Das Framework leitet jedoch automatisch Anforderungen weiter, wenn der Treiber die IQueueCallbackCreate::OnCreateFile-Methode nicht unterstützt. Wenn der Treiber IQueueCallbackCreate::OnCreateFileunterstützt, leitet das Framework Anforderungen nur weiter, wenn der Treiber die Weiterleitung explizit eingerichtet hat (WdfTrue) an den nächsten unteren Treiber.

Weitere Informationen dazu, wie ein UMDF-Treiber AutoForwardCreateCleanupCloseverwendet, finden Sie unter Verhindern eines Ungleichgewichts beim Erstellen und Schließen von Benachrichtigungen an einen Treiber.

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

Siehe auch

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize

Freigeben über