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 controladores UMDF nuevos deben escribirse con 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 con UMDF.
El método SetFilter establece la propiedad que habilita un dispositivo como dispositivo de filtro.
Sintaxis
void SetFilter();
Valor devuelto
None
Observaciones
Un controlador de filtro llama a SetFilter para marcarse como filtro. Cuando se le indica al marco 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 | Value |
|---|---|
| Finalización del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Versión mínima de UMDF | 1.5 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |