Partilhar via


Interface IKsPropertySet

[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.]

A IKsPropertySet interface foi originalmente projetada como uma maneira eficiente de definir e recuperar propriedades do dispositivo em drivers WDM, usando KSProxy para traduzir as chamadas de método COM no modo de usuário para os conjuntos de propriedades do modo kernel usados pelos drivers de classe de streaming WDM. Essa interface agora também é usada para passar informações estritamente entre componentes de software.

Em alguns casos, os componentes de software devem implementar essa interface ou então a interface IKsControl (documentada no DDK do DirectShow). Por exemplo, se você estiver escrevendo um decodificador MPEG-2 de software para uso com o Navegador de DVD, deverá implementar uma dessas interfaces e também dar suporte aos conjuntos de propriedades relacionados a DVD que o Navegador enviará ao decodificador. Os pinos podem dar suporte a uma dessas interfaces para permitir que outros pinos ou filtros definam ou recuperem suas propriedades.

Observação

Outra interface com esse nome existe no arquivo de cabeçalho dsound.h. As duas interfaces não são compatíveis. A interface IKsControl , documentada no DDK do DirectShow, agora é a interface recomendada para passar conjuntos de propriedades entre drivers WDM e componentes do modo de usuário.

 

Membros

A interface IKsPropertySet herda da interface IUnknown . IKsPropertySet também tem estes tipos de membros:

Métodos

A interface IKsPropertySet tem esses métodos.

Método Descrição
Get Recupera uma propriedade identificada por um GUID do conjunto de propriedades e uma ID de propriedade.
QuerySupported Determina se um objeto dá suporte a um conjunto de propriedades especificado.
Definir Define uma propriedade identificada por um GUID de conjunto de propriedades e uma ID de propriedade.

 

Comentários

Você deve incluir Ks.h antes de Ksproxy.h.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Ksproxy.h
Biblioteca
Strmiids.lib

Confira também

Conjuntos de propriedades