IAMErrorLog::LogError 메서드

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

LogError 메서드는 오류를 기록합니다. 애플리케이션은 이 메서드를 호출할 필요가 없습니다. 렌더링 오류에 대한 응답으로 내부적으로 호출됩니다.

구문

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

매개 변수

심각도

예약되어 있습니다. 사용하지 마십시오.

ErrorString

오류 텍스트를 포함하는 문자열 값입니다.

ErrorCode

오류 코드

Hresult

오류를 발생시킨 메서드 호출에서 반환된 HRESULT 값입니다.

pExtraInfo [in]

오류에 대한 추가 정보가 포함된 VARIANT에 대한 포인터입니다.

반환 값

hresult 매개 변수의 값을 반환합니다.

설명

이 메서드 내에서 pExtraInfo에서 가리키는 VARIANT를 해제하지 마세요. 또한 메서드가 반환된 후 VARIANT 가 유효하지 않으므로 나중에 참조하지 마세요.

가능한 한 빨리 반환하려면 이 메서드를 구현합니다. 프로그램 실행을 차단할 수 있는 이 메서드 내에서 함수를 호출하지 마세요. 예를 들어 창 메시지를 보내거나, 이벤트를 차단하거나, 실행이 차단될 수 있는 함수를 호출하지 마세요. 이렇게 하면 컴퓨터의 응답이 중지될 수 있습니다.

DES에서 정의한 오류 목록과 pExtraInfo에서 가리키는 VARIANT의 의미 및 데이터 형식은 렌더링 오류를 참조하세요.

요구 사항

추가 정보

IAMErrorLog 인터페이스

오류 및 성공 코드