DirectShow 보유 사용이 금지되고 있는 인터페이스 ICaptureGraphBuilder CopyCaptureFile   [목차열람] [주소복사] [슬롯비우기]

ICaptureGraphBuilder::CopyCaptureFile

주 :  ICaptureGraphBuilder 인터페이스의 사용은 피하는 것. 대신에,ICaptureGraphBuilder2 를 사용하는 것.

미리 할당된 캡춰 파일로부터 유효한 미디어 데이터를 복사 한다.

구문

HRESULT CopyCaptureFile(
    LPOLESTR lpwstrOld,
    LPOLESTR lpwstrNew,
    int fAllowEscAbort,
    IAMCopyCaptureFileProgress *pCallback
);

파라미터

lpwstrOld

[in] 복사원파일명이 저장 된 Unicode™ 캐릭터 라인의 포인터.

lpwstrNew

[in] 복사처 파일명이 저장 된 Unicode 캐릭터 라인의 포인터. 이 파일에 유효한 데이터가 복사 된다.

fAllowEscAbort

[in] Esc 키를 누르면 복사 조작이 중지될지 어떨지를 나타내는 값. TRUE 는 중지되는 것을 나타내, FALSE 는 이 메서드가 Esc 키 조작을 무시하는 것을 나타낸다.

pCallback

[in] 복사 조작의 진행 상황 (퍼센트 단위의 달성율)을 표시하는 IAMCopyCaptureFileProgress 에의 옵션의 포인터.

반환값

HRESULT 값을 돌려준다.

주의

새로운 파일에는 유효한 데이터만이 저장 되기 (위해)때문에, 복사원파일보다 새로운 파일이 훨씬 작아지는 일이 있다. 보통은, 항상, 미리 할당할 수 있던 같은 사이즈의 큰 파일에 캡춰 해, 이 메서드를 사용해, 각 캡춰로부터 보존하고 싶은 데이터만을 새로운 파일에 복사 한다.

pCallback 를 지정했을 경우는, 퍼센트 단위의 달성율에 상당하는 0 에서 100 의 사이의 정수를 지정해 IAMCopyCaptureFileProgress 인터페이스의 Progress 메서드를 정기적으로 호출한다.

참조

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