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。 此旗標會指定應用程式要求服務提供者填入的內容。 呼叫端可以設定下列三個值的一或多個值。
值 | Description |
---|---|
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 |
程式庫 | Mssachlp.lib |