Partilhar via

Conjuntos de propriedades (DirectShow)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEnginee Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize 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 oferecer suporte a serviços estendidos oferecidos pelo 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 para esses conjuntos de propriedades. Como desenvolvedor de aplicativos, você pode usar os métodos da interfaceIKsPropertySet para determinar se um driver ou filtro oferece suporte a um determinado conjunto de propriedades e recuperar ou definir essas propriedades.

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

As propriedades individuais podem ter dados associados que você especifica 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 suportados no DirectShow: