Функция 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

См. также

Функции