Partilhar via


Método IKsPropertySet::QuerySupported

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 in 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 QuerySupported método determina se um objeto dá suporte a um conjunto de propriedades especificado.

Sintaxe

HRESULT QuerySupported(
  [in]  REFGUID guidPropSet,
  [in]  DWORD   dwPropID,
  [out] DWORD   *pTypeSupport
);

Parâmetros

guidPropSet [in]

GUID do conjunto de propriedades.

dwPropID [in]

Identificador da propriedade dentro do conjunto de propriedades.

pTypeSupport [out]

Ponteiro para um valor no qual armazenar sinalizadores indicando o suporte fornecido pelo driver. Os sinalizadores com suporte incluem o seguinte.

Valor Descrição
KSPROPERTY_SUPPORT_GET Você pode recuperar a propriedade chamando o método IKsPropertySet::Get .
KSPROPERTY_SUPPORT_SET Você pode alterar a propriedade chamando IKsPropertySet::Set.

 

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
Há suporte para a combinação de IDs de propriedade e conjunto de propriedades especificados.
E_NOTIMPL
Não há suporte para o conjunto de propriedades.
E_PROP_ID_UNSUPPORTED
Não há suporte para a ID da propriedade para o conjunto de propriedades especificado.
E_PROP_SET_UNSUPPORTED
Não há suporte para o conjunto de propriedades.

 

Comentários

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.

 

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
Ks.h;
Ksproxy.h
Biblioteca
Strmiids.lib

Confira também

Códigos de erro e êxito

IKsPropertySet Interface

Conjuntos de propriedades