Метод IAMErrorLog::LogError

  • Статья

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

Примечание

[Не рекомендуется. Этот API может быть удален из будущих выпусков Windows.]

 

Метод LogError регистрирует ошибку. Приложениям не нужно вызывать этот метод. Он вызывается внутри в ответ на ошибки отрисовки.

Синтаксис

HRESULT LogError(
       LONG    Severity,
       BSTR    ErrorString,
       LONG    ErrorCode,
       HRESULT hresult,
  [in] VARIANT *pExtraInfo
);

Параметры

Уровень серьезности

Зарезервировано. Не используется.

ErrorString

Строковое значение, содержащее текст ошибки.

ErrorCode

Код ошибки.

Hresult

Значение HRESULT, возвращенное вызовом метода, вызвавшего ошибку.

pExtraInfo [in]

Указатель на variant, содержащий дополнительные сведения об ошибке.

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

Возвращает значение параметра hresult .

Комментарии

В этом методе не освобождайте variant , на который указывает pExtraInfo. Кроме того, variant становится недопустимым после возврата метода, поэтому не пытайтесь ссылаться на него позже.

Реализуйте этот метод, чтобы возвращать как можно быстрее. Не следует выполнять вызовы функций из этого метода, которые могут блокировать выполнение программы. Например, не вызывайте функции, которые отправляют сообщения окна, блокируют события или иным образом могут блокировать выполнение. Это может привести к тому, что компьютер перестанет отвечать на запросы.

Список ошибок, определенных DES, а также значение и тип данных VARIANT , на который указывает pExtraInfo, см. в разделе Ошибки отрисовки.

Примечание

Файл заголовка Qedit.h несовместим с заголовками Direct3D более поздней версии 7.

 

Примечание

Чтобы получить Qedit.h, скачайте обновление Microsoft Windows SDK для Windows Vista и платформа .NET Framework 3.0. Qedit.h недоступен в Microsoft Windows SDK для Windows 7 и платформа .NET Framework 3.5 с пакетом обновления 1 (SP1).

 

Требования

Требование Значение
Заголовок
Qedit.h
Библиотека
Strmiids.lib

См. также раздел

Интерфейс IAMErrorLog

Коды ошибок и успешности