IKsPropertySet：：Set 方法

  • 项目

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 Set 设置由属性集 GUID 和属性 ID 标识的属性。

语法

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 缓冲区的 Sise（以字节为单位）。

返回值

返回 HRESULT 值。 可能的值包括以下值。

返回代码 说明
S_OK
 成功。
E_PROP_SET_UNSUPPORTED
 不支持属性集。
E_PROP_ID_UNSUPPORTED
 指定的属性集不支持属性 ID。

 

备注

注意

dsound.h 头文件中存在另一个此名称的接口。 这两个接口不兼容。 DirectShow DDK 中记录的 IKsControl 接口现在是在 WDM 驱动程序和用户模式组件之间传递属性集的推荐接口。

 

必须在 Ksproxy.h 之前包括 Ks.h。

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
标头
Ksproxy.h
库
Strmiids.lib

另请参阅

错误和成功代码

IKsPropertySet 接口

属性集