Metodo IWDFDeviceInitialize::AutoForwardCreateCleanupClose (wudfddi.h)

Articolo
02/07/2025

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]

Il metodo AutoForwardCreateCleanupClose controlli quando si creano, puliscono e si chiudono le notifiche vengono inoltrate al driver inferiore successivo nello stack di dispositivi.

Sintassi

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

Parametri

[in] State

Valore tipizzato WDF_TRI_STATE che identifica lo stato dell'inoltro automatico. Nella tabella seguente vengono illustrati i valori possibili.

Valore	Significato
WdfUseDefault (0)	Il framework usa lo schema di inoltro predefinito. Per altre informazioni, vedere la sezione Osservazioni seguente.
WdfFalse (1)	Il framework non inoltra le notifiche di creazione, pulizia e chiusura al driver inferiore successivo.
WdfTrue (2)	Il framework inoltra in modo sincrono le notifiche di creazione, pulizia e chiusura al driver inferiore successivo.

Valore restituito

Nessuno

Osservazioni

Se il driver UMDF passa WdfUseDefault per il parametro state in una chiamata a AutoForwardCreateCleanupClose, il framework usa uno schema di inoltro predefinito per creare, pulire e chiudere le notifiche che dipendono dal fatto che il driver sia un filtro o un driver di funzione:

Se il driver è un driver di filtro, lo schema di inoltro predefinito consiste nell'inoltrare in modo sincrono le notifiche al driver inferiore successivo.
Se il driver è un driver di funzione, lo schema di inoltro predefinito non prevede l'inoltro delle notifiche al driver inferiore successivo.

Se il framework è configurato per l'inoltro, inoltra le notifiche di pulizia e chiusura indipendentemente dal fatto che il driver supporti i metodi di interfaccia IFileCallbackCleanup::OnCleanupFile e IFileCallbackClose::OnClose File. Tuttavia, il framework inoltra automaticamente le richieste di creazione solo se il driver non supporta il metodo IQueueCallbackCreate::OnCreateFile. Se il driver supporta IQueueCallbackCreate::OnCreateFile, il framework inoltra le richieste di creazione solo se il driver configura in modo esplicito l'inoltro (WdfTrue) al driver inferiore successivo.

Per altre informazioni su come un driver UMDF usa AutoForwardCreateCleanupClose, vedere Impedire uno squilibrio delle notifiche di creazione e chiusura a un driver.

Fabbisogno

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione	Desktop
versione minima di UMDF	1.5
intestazione	wudfddi.h (include Wudfddi.h)
dll	WUDFx.dll

Vedere anche

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize

Condividi tramite