IWDFDeviceInitialize ::AutoForwardCreateCleanupClose, méthode (wudfddi.h)

Article
02/07/2025

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

Les contrôles de méthode AutoForwardCreateCleanupClose lors de la création, du nettoyage et de la fermeture des notifications sont transférés au pilote inférieur suivant dans la pile d’appareils.

Syntaxe

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

Paramètres

[in] State

Valeur WDF_TRI_STATE typée qui identifie l’état du transfert automatique. Le tableau suivant présente les valeurs possibles.

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

Valeur de retour

Aucun

Remarques

Si le pilote UMDF passe WdfUseDefault pour le paramètre State dans un appel à AutoForwardCreateCleanupClose, l’infrastructure utilise un schéma de transfert par défaut pour créer, nettoyer et fermer les notifications qui varient selon que le pilote est un pilote de filtre ou 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 vers le pilote inférieur suivant.
Si le pilote est un pilote de fonction, le schéma de transfert par défaut n’est pas de transférer les notifications vers le 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 en charge les méthodes d’interface IFileCallbackCleanup ::OnCleanupFile et IFileCallbackClose ::OnCloseFile. Toutefois, l’infrastructure transfère automatiquement les requêtes 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 de requêtes uniquement si le pilote configure explicitement le transfert (WdfTrue) au 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 des notifications à un pilote.

Exigences

Exigence	Valeur
fin du support	Indisponible dans UMDF 2.0 et versions ultérieures.
plateforme cible	Bureau
version minimale de UMDF	1.5
d’en-tête	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IFileCallbackCleanup ::OnCleanupFile

IFileCallbackClose ::OnCloseFile

IQueueCallbackCreate ::OnCreateFile

IWDFDeviceInitialize

Partager via