Méthode IWDFDeviceInitialize ::AutoForwardCreateCleanupClose (wudfddi.h)

Article
02/27/2024

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode AutoForwardCreateCleanupClose contrôle quand les notifications de création, de nettoyage et de fermeture sont transférées au pilote inférieur suivant dans la pile de périphériques.

Syntaxe

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

Paramètres

[in] State

Valeur de type WDF_TRI_STATE qui identifie l’état du transfert automatique. Le tableau suivant répertorie les valeurs possibles.

Value	Signification
WdfUseDefault (0)	Le framework utilise le schéma de transfert par défaut. Pour plus d'informations, consultez la section Notes qui suit.
WdfFalse (1)	L’infrastructure ne transfère pas les notifications de création, de nettoyage et de fermeture au pilote inférieur suivant.
WdfTrue (2)	L’infrastructure transfère de façon synchrone les notifications de création, de nettoyage et de fermeture au pilote inférieur suivant.

Valeur de retour

None

Remarques

Si le pilote UMDF transmet WdfUseDefault pour le paramètre State dans un appel à AutoForwardCreateCleanupClose, le framework utilise un schéma de transfert par défaut pour les notifications de création, de nettoyage et de fermeture qui varie selon que le pilote est un filtre ou un pilote de fonction :

Si le pilote est un pilote de filtre, le schéma de transfert par défaut consiste à transférer de manière synchrone les notifications au pilote inférieur suivant.
Si le pilote est un pilote de fonction, le schéma de transfert par défaut ne consiste pas à transférer les notifications au pilote inférieur suivant.

Si l’infrastructure est configurée pour le transfert, elle transfère les notifications de nettoyage et de fermeture, que le pilote prenne ou non en charge les méthodes d’interface IFileCallbackCleanup ::OnCleanupFile et IFileCallbackClose ::OnCloseFile . Toutefois, l’infrastructure transfère automatiquement les demandes de création uniquement si le pilote ne prend pas en charge la méthode IQueueCallbackCreate ::OnCreateFile . Si le pilote prend en charge IQueueCallbackCreate ::OnCreateFile, l’infrastructure transfère les demandes de création uniquement si le pilote a explicitement configuré le transfert (WdfTrue) vers le pilote inférieur suivant.

Pour plus d’informations sur la façon dont un pilote UMDF utilise AutoForwardCreateCleanupClose, consultez Prévention d’un déséquilibre de la création et de la fermeture de notifications à un pilote.

Configuration requise

Condition requise	Valeur
Fin de la prise en charge	Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
Version UMDF minimale	1.5
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IFileCallbackCleanup ::OnCleanupFile

IFileCallbackClose ::OnCloseFile

IQueueCallbackCreate ::OnCreateFile

IWDFDeviceInitialize

Partager via