DirectShow DirectShow 레퍼런스 인터페이스 IGraphBuilder SetLogFile   [목차열람] [주소복사] [슬롯비우기]

IGraphBuilder::SetLogFile

SetLogFile 메서드는, 로그 파일을 설정한다. 이 파일에는 조작을 실행하려고 했을 때에 행해진 각 액션이 출력된다.

구문

HRESULT SetLogFile(
  DWORD_PTR hFile
);

파라미터

hFile

로그 파일의 핸들.

반환값

S_OK 를 돌려준다.

주의

이 메서드는 디버그에 사용해, 필터 그래프의 자동 생성에 실패했을 때에, 그 원인을 판단하는 것을 목적으로 하고 있다.

hFile 인수는, 연 파일 핸들이 아니면 안된다. 파일을 열어, 로그 출력이 끝나고 나서 파일을 닫는 것은, 애플리케이션측의 책임이다. 파일 핸들을 닫기 전에, 파일 핸들 NULL 로 SetLogFile 를 호출한다. 이렇게 하면 이미 닫은 파일 핸들을 구성 요소가 사용하지 않게 방지할 수 있다.

참조

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