Estructura KSFILTER (ks.h)
La estructura KSFILTER describe un filtro con instancias.
Sintaxis
typedef struct _KSFILTER {
const KSFILTER_DESCRIPTOR *Descriptor;
KSOBJECT_BAG Bag;
PVOID Context;
} KSFILTER, *PKSFILTER;
Miembros
Descriptor
Puntero a una estructura KSFILTER_DESCRIPTOR que describe las características de este filtro determinado.
Bag
Este miembro especifica el KSOBJECT_BAG (equivalente al tipo PVOID) asociado a esta instancia de filtro. bolsas de objetos son estructuras que se usan para asociar la memoria dinámica a un objeto AVStream específico. Todo lo que se encuentra en el contenedor de objetos de filtro se limpia automáticamente cuando se elimina el filtro.
Context
Puntero que usa el cliente para asociar información de contexto a la instancia de filtro específica. Normalmente, esta información de contexto se asocia en la del filtro Crear miembro tal como se define en la tabla de KSFILTER_DISPATCH para esta instancia de filtro. Cualquier información de contexto asignada dinámicamente debe colocarse en el contenedor de objetos con KsAddItemToObjectBag. de contexto se inicializa con el valor del miembro Context del KSFILTERFACTOR Y primario en el momento en que se crea el filtro. Consulte jerarquía de objetos AVStream.
Observaciones
Los controladores que implementan filtros de software suelen asociar el estado de filtro a la estructura KSFILTER. Normalmente, los filtros de software procesan datos dentro de la devolución de llamada especificada por el miembro Process de la estructura de KSFILTER_DISPATCH correspondiente.
Los filtros de hardware normalmente no usan KSFILTER porque el foco del controlador de hardware es la transición de la plataforma: el movimiento de datos entre el host y el hardware externo. Normalmente, esta transición se controla mediante código asociado a un objeto de cola avStream.
Vea también bolsas de objetos.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows XP y sistemas operativos posteriores y en Microsoft DirectX 8.0 y versiones posteriores. |
| encabezado de | ks.h (incluya Ks.h) |