IWDFDeviceInitialize::AutoForwardCreateCleanupClose-Methode (wudfddi.h)

Artikel
08/08/2023

[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 AutoForwardCreateCleanupClose-Methode steuert, wann Benachrichtigungen zum Erstellen, Bereinigen und Schließen an den nächstniedrigen Treiber im Gerätestapel weitergeleitet werden.

Syntax

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

Parameter

[in] State

Ein WDF_TRI_STATE typisierter Wert, der den Status der automatischen Weiterleitung angibt. 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ächstniedrigen Treiber weiter.
WdfTrue (2)	Das Framework leitet Erstellungs-, Bereinigungs- und Schließenbenachrichtigungen synchron an den nächstniedrigen Treiber weiter.

Rückgabewert

Keine

Bemerkungen

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

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

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

Weitere Informationen dazu, wie ein UMDF-Treiber AutoForwardCreateCleanupClose verwendet, 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
UMDF-Mindestversion	1.5
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize

Freigeben über