Compartilhar via


Conjuntos de propriedades (DirectShow)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O Microsoft DirectShow usa conjuntos de propriedades para dar suporte a serviços estendidos oferecidos por hardware e seus drivers e filtros associados. Os fornecedores de hardware e filtro podem definir novos recursos como propriedades, organizá-los em conjuntos de propriedades e publicar a especificação desses conjuntos de propriedades. Como desenvolvedor de aplicativos, você pode usar os métodos da interface IKsPropertySet para determinar se um driver ou filtro dá suporte a um determinado conjunto de propriedades e recuperar ou definir essas propriedades.

Todos os métodos expostos por IKsPropertySet exigem um GUID que identifica o conjunto de propriedades (o parâmetro guidPropSet ) e um DWORD que identifica a propriedade dentro do conjunto de propriedades (o parâmetro dwPropID ). O parâmetro dwPropID normalmente é um membro de um tipo de dados enumerado.

Propriedades individuais podem ter dados associados especificados no parâmetro pPropData nos métodos IKsPropertySet::Set e IKsPropertySet::Get . Nesses métodos, os dados da propriedade são digitados como um ponteiro para void. O tipo de dados e o significado dos dados são especificados na definição do conjunto de propriedades.

As seções a seguir fornecem informações sobre os conjuntos de propriedades com suporte no DirectShow: