Compartilhar 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 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 Audio/Video Capture 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 uma 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 no IKsPropertySet::Set e métodos IKsPropertySet::Get. Nesses métodos, os dados da propriedade são digitado 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: