Método IWDFDeviceInitialize::SetFilter (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
El método SetFilter establece la propiedad que habilita un dispositivo como dispositivo de filtro.
Sintaxis
void SetFilter();
Valor devuelto
Ninguno
Observaciones
Un controlador de filtro llama a SetFilter para marcarse como filtro. Cuando se indica al marco de trabajo que el controlador es un filtro, el marco:
- Envía solicitudes de E/S para las que el filtro no ha registrado una devolución de llamada al siguiente controlador lógico de la pila. Por ejemplo, el controlador de filtro proporciona un método IQueueCallbackDeviceIoControl::OnDeviceIoControl, pero no IQueueCallbackRead::OnRead o IQueueCallbackWrite::OnWrite. Como resultado, el controlador de filtro solo recibe solicitudes de control de E/S del dispositivo.
- Reenvía automáticamente las solicitudes de creación, limpieza y cierre de archivos para que el controlador no necesite llamar al método IWDFDeviceInitialize::AutoForwardCreateCleanupClose.
Ejemplos
Para obtener un ejemplo de código sobre cómo usar el método SetFilter, vea IWDFDriver::CreateDevice.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.5 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |