Méthode IWDFDeviceInitialize ::SetFilter (wudfddi.h)
[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 SetFilter définit la propriété qui active un appareil en tant qu’appareil de filtre.
Syntaxe
void SetFilter();
Valeur de retour
None
Remarques
Un pilote de filtre appelle SetFilter pour marquer lui-même en tant que filtre. Lorsque vous indiquez à l’infrastructure que votre pilote est un filtre, l’infrastructure :
- Envoie les demandes d’E/S pour lesquelles le filtre n’a pas inscrit de rappel au pilote logique suivant dans la pile. Par exemple, votre pilote de filtre fournit une méthode IQueueCallbackDeviceIoControl ::OnDeviceIoControl , mais pas IQueueCallbackRead ::OnRead ou IQueueCallbackWrite ::OnWrite. Par conséquent, votre pilote de filtre reçoit uniquement les demandes de contrôle d’E/S de périphérique.
- Transfère automatiquement les demandes de création, de nettoyage et de fermeture de fichiers afin que votre pilote n’ait pas besoin d’appeler la méthode IWDFDeviceInitialize ::AutoForwardCreateCleanupClose .
Exemples
Pour obtenir un exemple de code montrant comment utiliser la méthode SetFilter , consultez IWDFDriver ::CreateDevice.
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 |