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 值。 可能的值包括以下值。
| 返回代码 | 说明 |
|---|---|
|
成功。 |
|
不支持属性集。 |
|
指定的属性集不支持属性 ID。 |
备注
注意
dsound.h 头文件中存在另一个此名称的接口。 这两个接口不兼容。 DirectShow DDK 中记录的 IKsControl 接口现在是在 WDM 驱动程序和用户模式组件之间传递属性集的推荐接口。
必须在 Ksproxy.h 之前包括 Ks.h。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
| 标头 |
|
| 库 |
|
另请参阅