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


Метод IKsPropertySet::Set

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

Метод Set задает свойство, определяемое идентификатором GUID набора свойств и идентификатором свойства.

Синтаксис

HRESULT Set(
  [in] REFGUID guidPropSet,
  [in] DWORD   dwPropID,
  [in] LPVOID  pInstanceData,
  [in] DWORD   cbInstanceData,
  [in] LPVOID  pPropData,
  [in] DWORD   cbPropData
);

Параметры

guidPropSet [in]

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

dwPropID [in]

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

pInstanceData [in]

Указатель на буфер, содержащий данные экземпляра для свойства .

cbInstanceData [in]

Размер буфера pInstanceData в байтах.

pPropData [in]

Указатель на буфер, содержащий значение свойства .

cbPropData [in]

Размер буфера pPropData в байтах.

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

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

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

 

Комментарии

Примечание

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

 

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

Требования

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

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

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

Интерфейс IKsPropertySet

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