Метод 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 . Ниже приведены возможные значения.
Код возврата | Описание |
---|---|
|
Успешно. |
|
Набор свойств не поддерживается. |
|
Идентификатор свойства не поддерживается для указанного набора свойств. |
Комментарии
Примечание
Другой интерфейс с таким именем существует в файле заголовка dsound.h. Эти два интерфейса несовместимы. Интерфейс IKsControl , описанный в directShow DDK, теперь является рекомендуемым интерфейсом для передачи наборов свойств между драйверами WDM и компонентами пользовательского режима.
Необходимо включить Ks.h перед Ksproxy.h.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
Заголовок |
|
Библиотека |
|
См. также раздел