Поделиться через

Метод IKsPropertySet::QuerySupported

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод QuerySupported определяет, поддерживает ли объект указанный набор свойств.

Синтаксис

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

Параметры

guidPropSet [in]

Идентификатор GUID набора свойств.

dwPropID [in]

Идентификатор свойства в наборе свойств.

pTypeSupport [out]

Указатель на значение, в котором хранятся флаги, указывающие поддержку, предоставляемую драйвером. К поддерживаемым флагам относятся следующие.

Значение Описание
KSPROPERTY_SUPPORT_GET Свойство можно получить, вызвав метод IKsPropertySet::Get .
KSPROPERTY_SUPPORT_SET Свойство можно изменить, вызвав метод IKsPropertySet::Set.

 

Возвращаемое значение

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата Описание
S_OK
 Поддерживается указанное сочетание набора свойств и идентификатора свойства.
E_NOTIMPL
 Набор свойств не поддерживается.
E_PROP_ID_UNSUPPORTED
 Идентификатор свойства не поддерживается для указанного набора свойств.
E_PROP_SET_UNSUPPORTED
 Набор свойств не поддерживается.

 

Комментарии

Примечание

Другой интерфейс с таким именем существует в файле заголовка dsound.h. Эти два интерфейса несовместимы. Интерфейс IKsControl , описанный в directShow DDK, теперь является рекомендуемым интерфейсом для передачи наборов свойств между драйверами WDM и компонентами пользовательского режима.

 

Необходимо включить Ks.h перед Ksproxy.h.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Ks.h;
Ksproxy.h
Библиотека
Strmiids.lib

См. также раздел

Коды ошибок и успешности

Интерфейс IKsPropertySet

Наборы свойств