Функция AMGetErrorTextA (errors.h)

Статья
11/20/2024

[Функция, связанная с этой страницей, DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngineи аудио и видеозахват в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать новый код MediaPlayer, IMFMediaEngine и аудио-видеозахват в Media Foundation вместо DirectShowпо возможности. Корпорация Майкрософт предлагает, что существующий код, использующий устаревшие API, будет перезаписан для использования новых API, если это возможно.]

Функция AMGetErrorText извлекает сообщение об ошибке для заданного кода возврата с помощью текущего параметра языка.

Эта функция преобразует HRESULT коды возврата в сообщения об ошибках. Константная MAX_ERROR_TEXT_LEN указывает максимальное количество символов в сообщении об ошибке.

Синтаксис

AMOVIEAPI DWORD AMGetErrorTextA(
  HRESULT hr,
  LPSTR   pbuffer,
  DWORD   MaxLen
);

Параметры

hr

значение HRESULT.

pbuffer

Указатель на буфер символов, получающий сообщение об ошибке.

MaxLen

Количество символов в pBuffer.

Возвращаемое значение

Возвращает количество символов, возвращаемых в буфере, или ноль, если произошла ошибка.

Замечания

Заметка

Заголовок errors.h определяет AMGetErrorText как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	errors.h
библиотеки	Qualcom.lib

См. также

Функции

Поделиться через