Метод IWMDMDevice2::GetFormatSupport2 (mswmdm.h)

Статья
02/29/2024

Метод 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

DWORD , указывающий аудиоформаты, форматы видео и типы MIME. Этот флаг указывает, что приложение запрашивает у поставщика услуг для заполнения. Вызывающий объект может задать одно или несколько из следующих трех значений.

Значение	Описание
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
Коды ошибок Windows, преобразованные в значения HRESULT
Коды ошибок диспетчер устройств Windows Media

Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Этот метод расширяет возможности IWMDMDevice::GetFormatSupport для обработки форматов видео. Однако рекомендуемый метод для получения поддержки формата — IWMDMDevice3::GetFormatCapability. Если GetFormatCapability не поддерживается, скорее всего, устройство не будет поддерживать видео, и getFormatSupport , вероятно, достаточно.