DirectShow DirectShow 편집 서비스 C++ 레퍼런스 인터페이스 IAMErrorLog LogError   [목차열람] [주소복사] [슬롯비우기]

IAMErrorLog::LogError

LogError 메서드는, 에러를 로그에 기록한다. 애플리케이션으로 이 메서드를 호출할 필요는 없다. 이 메서드는, 렌더링 에러에 응답해 내부적으로 호출된다.

구문

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

파라미터

Severity

예약이 끝난 상태. 사용 불가.

ErrorString

에러의 텍스트를 포함한 캐릭터 라인값.

ErrorCode

에러 코드.

hresult

에러를 일으킨 메서드 호출로 돌려주어진 HRESULT 값.

pExtraInfo

[in] 에러에 관한 추가 정보가 포함되는 VARIANT 형의 포인터.

반환값

HRESULT 값을 돌려준다. hresult 인수의 값을 돌려준다.

주의

이 메서드 중(안)에서,pExtraInfo 가 가리키는 VARIANT 를 릴리즈 해서는 안 된다. 또, VARIANT 는 메서드가 돌아온 후는 무효가 되므로, 다음에 참조해서는 안 된다.

이 메서드가 가능한 한 빨리 돌아오도록(듯이) 처리 하는 것. 이 메서드 중(안)에서, 프로그램의 실행을 정지시키는 것 같은 함수 호출을 해서는 안 된다. 예를 들어, 윈도우 메시지의 송신, 이벤트의 블록 등, 실행의 방해가 되는 Microsoft® Win32® 함수를 호출해서는 안 된다. 그러한 일을 실시하면, 컴퓨터가 응답을 정지하거나"헹" 하는 일이 있다.

DES 로 정의되고 있는 에러의 일람, 및 pExtraInfo 가 가리키는 VARIANT 의 의미와 데이터형에 대해서는, 「렌더링 에러」를 참조할것.

요건

헤더 : Qedit.h 를 인클루드 한다. 이 헤더 파일은, 버전 7 이후의 Microsoft® Direct3D® 의 헤더와는 호환성이 없다.

라이브러리 : strmiids.lib 를 사용.

참조

• IAMErrorLog 인터페이스
• 에러 코드와 성공 코드