Conjuntos de propiedades (DirectShow)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Microsoft DirectShow usa conjuntos de propiedades para admitir servicios extendidos ofrecidos por hardware y sus controladores y filtros asociados. Los proveedores de hardware y filtros pueden definir nuevas funcionalidades como propiedades, organizarlas en conjuntos de propiedades y publicar la especificación de estos conjuntos de propiedades. Como desarrollador de aplicaciones, puede usar los métodos de la interfaz IKsPropertySet para determinar si un controlador o filtro admite un conjunto determinado de propiedades y recuperar o establecer esas propiedades.

Todos los métodos expuestos por IKsPropertySet requieren un GUID que identifique el conjunto de propiedades (el parámetro guidPropSet ) y un DWORD que identifique la propiedad dentro del conjunto de propiedades (el parámetro dwPropID ). El parámetro dwPropID suele ser miembro de un tipo de datos enumerado.

Las propiedades individuales pueden tener datos asociados que especifique en el parámetro pPropData en los métodos IKsPropertySet::Set e IKsPropertySet::Get . En estos métodos, los datos de propiedad se escriben como puntero a void. El tipo de datos y el significado de los datos se especifican en la definición del conjunto de propiedades.

En las secciones siguientes se proporciona información sobre los conjuntos de propiedades admitidos en DirectShow:

• Conjunto de propiedades de protección de copia de DVD
• Conjunto de propiedades de karaoke de DVD
• Conjunto de propiedades subpicture de DVD
• Conjunto de propiedades de transporte de dispositivos externos
• Conjunto de propiedades paso a paso de fotogramas
• Conjunto de propiedades Pin
• Conjunto de propiedades de cambio de frecuencia