Функция AMGetErrorTextA (errors.h)
[Функция, связанная с этой страницей 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | errors.h |
Библиотека | Quartz.lib |