iWMDMDevice2::GetFormatSupport2 方法 (mswmdm.h)
GetFormatSupport2 方法检索设备支持的格式,包括音频和视频编解码器以及 MIME 文件格式。
语法
HRESULT GetFormatSupport2(
[in] DWORD dwFlags,
[out] _WAVEFORMATEX **ppAudioFormatEx,
[out] UINT *pnAudioFormatCount,
[out] _VIDEOINFOHEADER **ppVideoFormatEx,
[out] UINT *pnVideoFormatCount,
[out] WMFILECAPABILITIES **ppFileType,
[out] UINT *pnFileTypeCount
);
参数
[in] dwFlags
指定音频格式、视频格式和 MIME 类型的 DWORD。 此标志指定应用程序请求服务提供商填写的内容。 调用方可以设置以下三个值中的一个或多个。
值 | 说明 |
---|---|
WMDM_GET_FORMAT_SUPPORT_AUDIO | 服务提供商应填写音频参数。 |
WMDM_GET_FORMAT_SUPPORT_VIDEO | 服务提供商应填写视频参数。 |
WMDM_GET_FORMAT_SUPPORT_FILE | 服务提供商应填写文件参数。 |
[out] ppAudioFormatEx
指向 _WAVEFORMATEX 结构的数组的指针,这些结构指定有关设备支持的音频编解码器和比特率的信息。 此参数的内存由 Windows Media 设备管理器分配,必须由调用方使用 Win32 函数 CoTaskMemFree 释放。
[out] pnAudioFormatCount
指向指定音频格式计数的整数的指针。
[out] ppVideoFormatEx
指向 _VIDEOFORMATEX 结构的数组的指针,这些结构指定有关设备支持的视频代码和格式的信息。 此参数的内存由 Windows Media 设备管理器分配,必须由调用方使用 Win32 函数 CoTaskMemFree 释放。
[out] pnVideoFormatCount
指向指定视频格式计数的整数的指针。
[out] ppFileType
指向 WMFILECAPABILITIES 文件类型对象数组的指针。 此参数的内存由 Windows Media 设备管理器分配,必须由调用方使用 Win32 函数 CoTaskMemFree 释放。
[out] pnFileTypeCount
指向指定文件类型计数的整数的指针。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
注解
此方法扩展 IWMDMDevice::GetFormatSupport 以处理视频格式。 但是,获取格式支持的建议方法是 IWMDMDevice3::GetFormatCapability。 如果 不支持 GetFormatCapability ,则设备可能不支持视频,并且 GetFormatSupport 可能已足够。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |