IWDFDeviceInitialize ::SetFilter, méthode (wudfddi.h)
[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.]
La méthode SetFilter définit la propriété qui active un appareil en tant qu’appareil de filtre.
void SetFilter();
Aucun
Un pilote de filtre appelle SetFilter pour se marquer comme filtre. Lorsque vous indiquez au framework 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 d’appareil.
- Transfère automatiquement les demandes de création, de nettoyage et de fermeture du fichier afin que votre pilote n’ait pas besoin d’appeler la méthode IWDFDeviceInitialize ::AutoForwardCreateCleanupClose.
Pour obtenir un exemple de code montrant comment utiliser la méthode SetFilter, consultez IWDFDriver ::CreateDevice.
| 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 |