Metodo IWDFDeviceInitialize::AutoForwardCreateCleanupClose (wudfddi.h)

  • Articolo

[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 info, vedi Introduzione con UMDF.]

Il metodo AutoForwardCreateCleanupClose controlla quando vengono inoltrate notifiche di creazione, pulizia e chiusura 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 sono illustrati i possibili valori.

Valore Significato
WdfUseDefault (0) Il framework usa lo schema di inoltro predefinito. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
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 le notifiche di creazione, pulizia e chiusura 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::OnCloseFile . 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 Prevenzione di uno squilibrio di creazione e chiusura delle notifiche a un driver.

Requisiti

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1.5
Intestazione wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Vedi anche

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize