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

另请参阅

发现设备格式功能

IWMDMDevice2 接口

IWMDMDevice3::GetFormatCapability