DirectShow DirectShow 샘플 DMO 샘플 DMO 샘플   [목차열람] [주소복사] [슬롯비우기]

DMO 샘플

설명

DMO 샘플은, Microsoft® DirectX® Media Object (DMO)의 샘플이다. MPEG-1 비디오 패킷을 입력으로 해, 출력 스트림을 2 개 생성한다. 최초의 출력 스트림에는, RGB 565 포맷의 비디오 프레임이 포함되어 있다. 각 프레임은 MPEG-1 비디오로부터 취득한 타임 코드를 표시해, 그것이 없는 경우는 아무것도 표시하지 않는다. 2 번째의 출력 스트림은, 타임 코드가 붙은, 옵션의 텍스트 스트림이다.

DMO 샘플은,IMediaObjectImpl 클래스 템플릿을 사용해,IMediaObject 인터페이스를 처리 한다. Active Template Library (ATL)는, 등록, 집합,IUnknown, DLL 엔트리 포인트 등, 다양한 COM 의 상세를 처리한다.

패스

소스 : (SDK 루트) \Samples\C++\DirectShow\DMO\DMOSample

사용자 가이드

이 프로젝트 워크 스페이스에서는, Dmosample.dll 라는 이름의 DLL 를 생성 한다. Regsvr32 유틸리티를 사용해 DLL 를 등록한다. 이 DMO 의 동작을 보려면 , Microsoft® DirectShow® GraphEdit 유틸리티를 사용한다. 다만, MPEG-1 비디오 파일이 필요하다. 다음의 스텝을 실행한다.

1. GraphEdit 를 실행한다.
2. MPEG-1 파일을 렌더링 한다.
   • [File] 메뉴의 [Render Media File] 를 클릭한다.
   • MPEG-1 비디오 파일을 선택해,[Open] 를 클릭한다.
3. 필터 그래프로부터 MPEG-1 비디오 디코더 필터를 선택해, Del 키를 눌러 삭제한다.
4. 그래프에 DMO 샘플을 삽입한다.
   • [Graph] 메뉴의 [Insert Filters] 를 클릭한다.
   • [DirectShow Filters] 리스트를 전개한다.
   • [DMO Sample] 를 선택해,[Insert Filters] 를 클릭한다.
   • [Close] 를 클릭한다.
5. MPEG-1 스트림 스플리터 위에의 [Video] 라고 하는 라벨이 붙은 작은 박스로부터, DMO 샘플 위에의 [in0] 라고 하는 박스까지 마우스를 드러그 해,MPEG-1 스트림 스플리터를 DMO 샘플에 접속한다 (그림을 참조할것).
6. DMO 샘플을비디오 렌더러에 접속한다.
   • DMO 샘플 위에의 [out0] 라고 하는 라벨이 붙은 박스로부터, 비디오 렌더러 위에의 [Input] 라고 하는 라벨이 붙은 박스까지 마우스를 드러그 한다.
   • GraphEdit 에 의해, RGB 타입간의 변환을 실시하는색공간변환 필터가 자동적으로 삽입된다.
7. [GraphEdit] 툴바의 [Play] 버튼을 누르는지, 또는 [Graph] 메뉴의 [Play] 를 클릭한다.

그래프를 실행 하면, 타임 코드를 표시하는 [Video] 윈도우가 나타난다.

프로그래밍 정보

DMO 샘플에는, 이하의 소스 파일이 포함되어 있다.

다음의 주의는, 처리에 대해 상세하게 설명하고 있다.

Dmosample.cpp

이 파일에는, ATL 가 DMO 개체를 생성 해 등록하기 위해서 사용하는 개체 맵이 포함된다. 또, export 되는 DLL 함수도 포함된다. 이러한 함수에는, 엔트리 포인트 함수 (DllMain), COM 에 필요한 함수 (DllCanUnloadNow,DllGetClassObject,DllRegisterServer,DllUnregisterServer)가 있다.

ATL COM AppWizard 는, 이 파일에 포함되는 코드의 대부분을 자동 생성한다. 다음의 2 개가 추가된다.

• DllRegisterServer 함수는,DMORegister 를 호출해, DMO 에 관한 레지스트리 정보를 추가한다. DMO 는 DMOCATEGORY_VIDEO_DECODER 카테고리에 등록된다.
• DllUnregisterServer 함수는 DMOUnregister 를 호출한다.

Resource.h

이 헤더 파일로 선언되는 1 개의 정수 IDR_SAMPLE 는, ATL 의 자동 등록 메카니즘으로 사용된다. 정수 IDR_SAMPLE 는, 리소스 파일 Sample.rgs 로 정의되어 리소스 파일 Dmosample.rc 에 의해 임포트 되는 텍스트 리소스를 식별한다. 헤더 파일 Sample.h 에는, 다음의 행이 있다.

DECLARE_REGISTRY_RESOURCEID(IDR_SAMPLE)  

이것에 의해, ATL 는 IDR_SAMPLE 리소스에 선언된 등록 정보를 사용할 수 있다.

Sample.h

DEFINE_GUID 매크로는, DMO 의 클래스 식별자 (CLSID)를 선언한다.

CSample 클래스는 다음의 클래스로부터 파생한다.

• IMediaObjectImpl 템플릿. 템플릿 파라미터는, DMO 가 1 개의 입력 스트림과 2 개의 출력 스트림을 가지는 것을 지정한다.
• CComObjectRootEx. thread 모델을 선언하는 ATL 클래스. 템플릿 파라미터 CComMultiThreadModel 는, thread 대응 개체를 생성 해,Lock 메서드와 Unlock 메서드를 제공한다.
• CComCoClass. 표준 COM 개체를 선언하는 ATL 클래스.

CSample 는, 커스텀 마샬링을 실행하는 후리스렛드마샤라개체를 모은다. COM 라이브러리가, 샘플 프로세스내의 복수의 thread에 걸쳐 CSample 포인터를 마샬링 하는 경우는, 완전히 같은 포인터가 반환된다. COM 라이브러리가 복수의 프로세스 또는 복수의 머신에 걸쳐 개체를 마샬링 하려고 하면 에러가 발생한다. ATL 는, 후리스렛드마샤라를 집성 하기 위해서 필요한 모든 코드를 추가한다. 이 코드는,FinalConstruct 메서드와 FinalRelease 메서드에 나타난다. COM 맵내의 COM_INTERFACE_ENTRY_AGGREGATE 엔트리는, 후리스렛드마샤라에 IMarshal 인터페이스를 위임한다.

CSample 클래스는, 다음의 멤버 변수를 선언한다.

Sample.cpp

이 파일은, CSample 클래스에 메서드를 처리 한다.

• InternalGetInputStreamInfo. DMO 는, 임의의 경계에 정렬된 임의의 바이트수를 처리할 수 있으므로, 이 메서드는 제로 플래그를 돌려준다.
• InternalGetOutputStreamInfo. 최초의 출력 스트림은, 고정 사이즈의 샘플 전체를 한 번에 생성 한다. 이것은, 비디오 디코더로 자주(잘) 행해진다. 2 번째의 출력 스트림은 옵션이다. 돌려받는 플래그는, 이러한 속성을 나타낸다.
• InternalCheckInputType. 입력 타입은, FORMAT_MPEGVide 포맷 타입의 MPEG-1 비디오 유료 하중이 아니면 안된다. 입력 타입의 설정 후, 메서드는 포맷의 변경을 받아들이지 않는다.
• InternalCheckOutputType. 이 메서드는, 출력 포맷을 검증한다. 출력 스트림은 다음의 2 개이다.
  • 스트림 0. 이 스트림으로 지원 되는 유일한 미디어 타입은 RGB-565 이다. 실제의 비디오 디코더는 보통, 복수의 포맷을 지원 한다. 또, 출력의 frame size는, 입력의 frame size와 일치해야 한다. 이것은, 실제의 비디오 디코더가 많게 들어맞는다. 이 스트림은, 입력 타입이 설정되지 않으면 설정할 수 없다.
  • 스트림 1. 미디어 타입은 MEDIATYPE_Text 가 아니면 안된다.

  타입의 설정 후, 새로운 타입이 현재의 타입에 일치하지 않는 경우, 메서드는 실패한다. DMO 가 스트리밍중으로 포맷 변경을 처리할 수 없는 경우는, 같은 코드를 포함할 필요가 있다. 실제, 샘플 DMO 는, 한 번에 1 개의 출력 프레임을 생성하므로, 포맷 변경을 용이하게 받아들일 수가 있다.

• InternalGetInputType. 이 메서드는, 타입을 돌려주지 않는다. 이 때문에, 모든 인덱스값이 범위외가 되어, 반환값은 DMO_E_NO_MORE_ITEMS 가 된다.
• InternalGetOutputType. 입력 타입이 설정되지 않은 경우, 이 메서드는 타입을 돌려주지 않는다. 설정되어 있는 경우는, 각 스트림에 1 개의 타입이 반환된다. 스트림 0 의 경우는, 입력 사이즈에 동일한 frame size의 RGB-565 가 반환된다. 스트림 1 의 경우는, MEDIATYPE_Text 가 반환된다.
• InternalGetInputSizeInfo. 입력 스트림의 최소 버퍼 사이즈는 1 바이트이며, alignment 요건은 없다. 스트림은 룩 어해드를 실행하지 않는다.
• InternalGetOutputSizeInfo. 스트림 0 의 경우, 버퍼는 출력 샘플을 보관 유지할 수 있는 사이즈가 필요하다. 스트림 1 의 경우, 버퍼는 타임 스탬프 첨부의 텍스트 캐릭터 라인을 보관 유지할 수 있는 사이즈가 필요하다.
• InternalFlush. 이 메서드는, m_pBuffer (ATL 스마트 포인터)를 NULL 로 설정하는 것으로, 입력 버퍼를 릴리즈 한다. 또, CStreamState 개체를 리셋 하는 InternalDiscontinuity 메서드도 호출한다.
• InternalProcessInput. 이 메서드는, 가능한 한 많은 입력 데이터를 처리한다. 이하의 스텝을 실행한다.

  1. IMediaBuffer::GetBufferAndLength 메서드를 호출해, 입력 데이터의 포인터와 입력 데이터의 사이즈를 얻어온다.

  2. 입력 버퍼의 참조 카운트를 보관 유지한다. m_pBuffer 변수는 ATL 스마트 포인터이므로, 이 변수에 값을 설정 하면,IUnknown::AddRef 메서드를 호출하는 효과를 갖는다.

  3. 타임 스탬프를 CStreamState 개체에 건네준다. 샘플에 타임 스탬프가 없는 경우는, 값 INVALID_TIME 를 사용한다.

  4. Private 헬퍼-메서드인 Process 를 호출해, 데이터를 처리한다.

• InternalProcessOutput. 출력하는 데이터가 없는 경우는, 이 메서드는 S_FALSE 를 돌려준다. 데이터가 있는 경우는, 출력 데이터를 생성한다. 스트림 0 의 경우는, 다음의 순서로 실행된다.

  1. 출력 버퍼가 출력 데이터를 보관 유지하는데 충분한 사이즈인 것을 확인한다. 충분한 사이즈가 없는 경우, 메서드는 에러를 돌려준다.

  2. OurFillRect 메서드를 호출해, 배경을 드로잉(Drawing) 해, DrawOurText 메서드를 호출해, 텍스트를 드로잉(Drawing) 한다.

  3. 타임 스탬프를 설정한다. 이 프레임에 유효한 타임 스탬프가 있는 경우는, 그것을 사용한다. 없는 경우는, 전의 타임 스탬프를 평균 frame rate로 인크리먼트(increment) 한다.

  4. Process 메서드를 다시 호출해, 입력 버퍼에 남아 있으면 모든 데이터를 처리한다. 이것에 의해 출력 데이터가 증가했을 경우는, DMO_OUTPUT_DATA_BUFFERF_INCOMPLETE 플래그를 설정한다.

  스트림 1 은 옵션이므로, 호출측은 스트림 1 용의 버퍼를 할당하지 않은 것이 있다. 스트림 1 에 출력 버퍼가 없다고 해도, DMO 는 타임 코드를 텍스트 캐릭터 라인으로서 기입한다. 타임 스탬프와 처리 플래그는 스트림 0 의 것을 참조한다.

• InternalAcceptingInput. DMO 에 전의 입력 버퍼의 참조 카운트가 아직 있는 경우, DMO 는 그 이상의 입력을 받아들이지 않는다.
• Process. 이 Private 메서드는, CStreamState 개체를 갱신하면서, 입력 데이터를 한 번에 1 바이트씩 순서에 처리한다. 입력 데이터를 처리 끝마치기까지 CStreamState 개체가 피크체바운다리를 찾아내면 Process 메서드는 S_OK 를 돌려준다. 그 이외의 경우는 S_FALSE 를 돌려준다.