# sys.mediaFoundation 库模块帮助文档 [sys.mediaFoundation 使用指南](https://www.aardio.com/zh-cn/docs/library/sys/mediaFoundation/) ## sys.mediaFoundation 成员列表 # 调用系统自带 Media Foundation（零依赖）读写音视频。本模块提供底层接口声明、GUID 表与属性工具函数。写 MP4 请导入 sys.mediaFoundation.writer，读取解码请导入 sys.mediaFoundation.reader。 MP3 解码请导入 sys.mediaFoundation.mp3Decoder ### sys.mediaFoundation.IMF2DBuffer # IMF2DBuffer 接口声明类 ### sys.mediaFoundation.IMFAttributes # IMFAttributes 接口声明类 ### sys.mediaFoundation.IMFMediaBuffer # IMFMediaBuffer 接口声明类 ### sys.mediaFoundation.IMFMediaType # IMFMediaType 接口声明类 ### sys.mediaFoundation.IMFSample # IMFSample 接口声明类 ### sys.mediaFoundation.IMFSinkWriter # IMFSinkWriter 接口声明类 ### sys.mediaFoundation.IMFSourceReader # IMFSourceReader 接口声明类 ### sys.mediaFoundation.PROPVARIANT() # PROPVARIANT 结构体（只用于数值类型） ### sys.mediaFoundation.api # 已声明的 Media Foundation API 函数 ### sys.mediaFoundation.available # 当前操作系统是否支持Media Foundation 组件（如部分 Windows Server 或精简版系统不支持） ### sys.mediaFoundation.createAttributes() # [返回对象:sysMfAttributesObject](#sysMfAttributesObject) ### sys.mediaFoundation.createAttributes(attributes) # 创建 IMFAttributes 接口对象并批量设置属性，失败返回 null,错误信息。属性表规则见 setAttributes ### sys.mediaFoundation.createMediaType() # [返回对象:sysMfAttributesObject](#sysMfAttributesObject) ### sys.mediaFoundation.createMediaType(attributes) # 创建 IMFMediaType 接口对象并批量设置属性，失败返回 null,错误信息。属性表规则见 setAttributes ### sys.mediaFoundation.getGUID(attrs,name) # 读取 GUID 属性，返回 win.guid 结构体 ### sys.mediaFoundation.getPair(attrs,name) # 读取 UINT64 属性并拆分，返回高32位,低32位。例如帧尺寸返回宽,高，帧率返回分子,分母 ### sys.mediaFoundation.getUINT32(attrs,name) # 读取 UINT32 属性，不存在返回 null ### sys.mediaFoundation.guidName(guid) # GUID 转可读名称，例如媒体子类型返回 "H264"、"AAC" ### sys.mediaFoundation.guids # GUID 表：MF_MT_*、MFMediaType_*、MFVideoFormat_*、MFAudioFormat_*、CODECAPI_* 等 ### sys.mediaFoundation.hresultText(hr,action) # HRESULT 错误码转错误信息 ### sys.mediaFoundation.setAttributes(attrs,attributes) # 批量设置属性，成功返回 true，失败返回 null,错误信息。键为 guids 表中的名称（或 GUID 字符串），值的类型决定写入方式：字符串 = GUID 名称或 GUID 字符串；数值、布尔值 = UINT32； {高32位,低32位} = UINT64，例如帧尺寸 {宽,高}、帧率 {分子,分母} ### sys.mediaFoundation.shutdown() # 对应一次 startup 调用（MFShutdown） ### sys.mediaFoundation.startup() # 初始化 Media Foundation（MFStartup），成功返回 true。可重复调用，每次调用都要对应一次 shutdown。 writer、reader 已自动调用，一般无需手动调用 ### sys.mediaFoundation.wrap(ptr,declInterface) # 把 API 返回的原生接口指针包装为接口对象，并释放原指针的引用 ## sysMfAttributesObject 成员列表 # ### sysMfAttributesObject.GetCount(0) # 返回 HRESULT,属性个数 ### sysMfAttributesObject.GetGUID(key,win.guid()) # 返回 HRESULT,GUID ### sysMfAttributesObject.GetUINT32(key,0) # 返回 HRESULT,值 ### sysMfAttributesObject.GetUINT64(key,0) # 返回 HRESULT,值 ### sysMfAttributesObject.Release() # 引用计数减一 ### sysMfAttributesObject.SetGUID(key,guid) # 设置 GUID 属性 ### sysMfAttributesObject.SetUINT32(key,value) # 设置 UINT32 属性，参数 @key 为 GUID 结构体 ### sysMfAttributesObject.SetUINT64(key,value) # 设置 UINT64 属性