Conjuntos de propiedades del codificador
En esta sección se describen los conjuntos de propiedades específicos de la API de codificador y códec que están disponibles para los minidrivers del codificador que usan los servicios de streaming de kernel de WDM en Microsoft Windows 98/Me, Windows 2000 y Windows XP y versiones posteriores.
La página de referencia de cada propiedad contiene una tabla con los encabezados de columna que se muestran a continuación.
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
Estos encabezados tienen los siguientes significados:
Get
¿El objeto KS de destino admite la solicitud de propiedad KSPROPERTY_TYPE_GET?
Establecimiento
¿El objeto KS de destino admite la solicitud de propiedad KSPROPERTY_TYPE_SET?
Target
Este es el objeto KS al que se envía la solicitud de propiedad. El destino de una propiedad de codificador de vídeo es un filtro o un pin. (La solicitud de propiedad especifica el objeto de destino por su identificador de kernel).
Tipo de descriptor de propiedad
El descriptor de propiedad especifica la propiedad y la operación que se va a realizar en esa propiedad. El descriptor siempre comienza con una estructura KSPROPERTY .
Tipo de valor de propiedad
Una propiedad tiene un valor y el tipo de este valor depende de la propiedad . Por ejemplo, una propiedad que puede estar en uno de solo dos estados,activado o desactivado, normalmente tiene un valor BOOL. Una propiedad que puede suponer valores enteros de 0x0 a 0xFFFFFFFF podría tener un valor de ULONG. Las propiedades más complejas pueden tener valores que son matrices o estructuras.
El descriptor de propiedad y el valor de propiedad anteriores son las versiones específicas de la propiedad de los búferes de búferes de especificaciones de instancia y datos de operación que se describen en Propiedades, Eventos y Métodos de KS.
Una solicitud de propiedad usa una de las marcas siguientes para especificar la operación que se va a realizar en la propiedad :
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Todos los objetos de filtro y anclaje admiten la operación de compatibilidad básica en sus propiedades. Si admiten las operaciones get y Set depende de la propiedad . Es probable que una propiedad que represente una funcionalidad inherente del objeto filter o pin solo requiera una operación get . Una propiedad que representa un valor configurable podría requerir solo una operación Set , aunque una operación get también podría ser útil para leer la configuración actual. Para obtener más información sobre el uso de las operaciones de obtención, establecimiento y soporte técnico básico con las propiedades del codificador de vídeo, consulte Propiedades de KS.
Una tabla de la descripción de cada propiedad indica si se requieren minidriveres de codificador de vídeo para admitir la lectura o escritura de la propiedad. Los minidrivers del codificador de vídeo deben devolver STATUS_NOT_SUPPORTED en respuesta a obtener o establecer solicitudes de propiedades que no son compatibles con el minidriver.
Los siguientes conjuntos de propiedades contienen una sola propiedad que deben implementarse mediante minidrivers de codificador de vídeo. Es decir, cada propiedad obtiene su propio conjunto, por lo que especifique 0 en el miembro PropertyId del miembro KSPROPERTY_ITEM en la estructura KSPROPERTY_SET según sea necesario.
Los siguientes conjuntos de propiedades pertenecen a la API de códec:
Los siguientes conjuntos de propiedades pertenecen a la API del codificador: