DirectX Media Object DMO 의 생성 DMO 클래스 템플릿의 사용법   [목차열람] [주소복사] [슬롯비우기]

DMO 클래스 템플릿의 사용법

DirectX SDK 에는, DMO 의 처리용으로,IMediaObjectImpl 라는 이름의 클래스 템플릿이 포함되어 있다. 템플릿에서는, 입력 파라미터의 확인이라고 하는 "정평" 처리가 많게를 하고 있다. 템플릿을 사용하면, 그 DMO 고유의 기능에만 전념할 수 있다. 게다가 템플릿은 견뢰한 처리을 생성 하는 도움으로도 된다. 템플릿은, SDK 의 Include 디렉토리에 있는 헤더 파일 Dmoimpl.h 중(안)에서 정의되고 있다.

IMediaObjectImpl 템플릿은,IMediaObject 인터페이스를 계승하고 있다. 이 템플릿을 사용해 DMO 를 생성 하려면 ,IMediaObjectImpl 로부터 파생하는 새로운 클래스를 정의한다. 템플릿에서는,IMediaObject 의 모든 메서드가 처리 되고 있다. 많은 경우, 템플릿은 상속 클래스에 대해 대응하는 Private 메서드를 호출한다. 템플릿은 이하의 기능을 제공한다.

• 기본적인 파라미터 체크. 템플릿의 메서드는, 필수 파라미터가 NULL 는 아니고, 스트림의 인덱스가 범위내이며, 플래그가 유효한 것을 검사한다.
• 락. 템플릿의 메서드는,Lock 와 Unlock 의 2 개의 내부 메서드를 호출해, DMO 에 관한 처리를 순서대로화한다. 이 기능에 의해, DMO 를 thread 세이프로 할 수 있다.
• 미디어 타입. 템플릿은, 클라이언트에 의해 설정된 미디어 타입을 보존해, 미디어 타입에 액세스하기 위한 메서드를 제공한다.
• 스트리밍. 템플릿은, 클라이언트가 옵션 이외의 모든 스트림의 미디어 타입을 설정할 때까지, 스트리밍을 실행하지 않는다. 또, 스트리밍이 시작 하기 전에, 반드시 IMediaObject::AllocateStreamingResources 메서드를 호출한다. 이것에 의해, 리소스의 할당이 보증된다.

IUnknown 인터페이스는 템플릿으로부터 제공되지 않기 때문에, 상속 클래스로 처리 해야 한다. IUnknown 는, ATL (Active Template Library)를 사용해 처리 할 수 있지만, 다른 처리을 제공해도 괜찮다. 또, 템플릿에는 잠금 메카니즘이 처리 되지 않는다. 상속 클래스는,Lock 메서드와 Unlock 메서드를 처리 할 필요가 있다. ATL 를 사용해 클래스를 생성 하는 경우는, ATL 의 디폴트의 처리을 사용할 수 있다.

상속 클래스의 선언

IMediaObjectImpl 클래스 템플릿은, 다음과 같이 선언되고 있다.

template <class _DERIVED_, int NUMBEROFINPUTS, int NUMBEROFOUTPUTS>
class IMediaObjectImpl : public ImediaObject

_DERIVED_, NUMBEROFINPUTS, NUMBEROFOUTPUTS 의 3 개는, 템플릿 파라미터이다. _DERIVED_ 에는, 클래스의 이름을 설정한다. 다른 2 개의 파라미터는, DMO 의 입력 스트림과 출력 스트림의 수를 정의한다. 예를 들어, 1 개의 입력 스트림과 2 개의 출력 스트림을 지원 하는 CMyDmo 라는 이름의 DMO 클래스를 생성 하려면 , 다음과 같이 선언한다.

class CMyDmo : public IMediaObjectImpl<CMyDmo, 1, 2>

다음에,IMediaObject 의 다양한 메서드가 템플릿으로 어떻게 처리 되고 있는지를 설명한다.

미디어 타입 설정용의 메서드

이하의 메서드는, DMO 의 미디어 타입을 설정 또는 얻어온다.

• GetInputType,GetOutputType. 이러한 메서드는, 스트림 번호와 타입 인덱스를 받아, 우선 미디어 타입을 돌려준다. 템플릿은, 상속 클래스의 InternalGetInputType 또는 InternalGetOutputType 를 호출한다.
• SetInputType,SetOutputType. 이러한 메서드는, 스트림에의 미디어 타입의 설정, 미디어 타입의 테스트, 또는 미디어 타입의 클리어를 실시한다. 미디어 타입을 검증하기 위해(때문에), 템플릿은 상속 클래스의 InternalCheckInputType 또는 InternalCheckOutputType 를 호출한다. 상속 클래스는, 타입을 받아들이는 경우는 S_OK 를 돌려주어, 거부하는 경우는 DMO_E_INVALIDTYPE 를 돌려준다. 템플릿은, 미디어 타입의 설정 또는 클리어를 처리한다.
• GetInputCurrentType,GetOutputCurrentType. 이러한 메서드는, 스트림에 대한 현재의 미디어 타입을 돌려준다. 타입이 설정되지 않은 경우는, DMO_E_TYPE_NOT_SET 를 돌려준다. 템플릿은, 이러한 메서드를 완전하게 처리 하고 있다.

정보 메서드

이하의 메서드는, DMO 에 대한 정보를 제공한다.

• GetInputMaxLatency,SetInputMaxLatency. 이러한 메서드는, 최대 지연 시간을 취득 또는 설정한다. 템플릿은, 상속 클래스의 InternalGetInputMaxLatency 또는 InternalSetInputMaxLatency 를 호출한다.
• GetInputSizeInfo,GetOutputSizeInfo. 이러한 메서드는, 지정된 스트림에 대한 DMO 의 버퍼 요건을 돌려준다. 그 스트림에 미디어 타입이 설정되지 않은 경우, 템플릿은 DMO_E_TYPE_NOT_SET 를 돌려준다. 미디어 타입이 설정되어 있는 경우는, 상속 클래스의 InternalGetInputSizeInfo 또는 InternalGetOutputSizeInfo 를 호출한다.
• GetInputStreamInfo,GetOutputStreamInfo. 이러한 메서드는, 클라이언트가 데이터의 포맷을 설정하는 방법을 나타내는 다양한 플래그를 돌려준다. 템플릿은, 상속 클래스의 InternalGetInputStreamInfo 또는 InternalGetOutputStreamInfo 를 호출한다.
• GetStreamCount. 이 메서드는, 입력 스트림과 출력 스트림의 수를 돌려준다. 템플릿은, 템플릿 파라미터를 사용해 이 메서드를 처리 한다.

리소스 할당용의 메서드

• AllocateStreamingResources 메서드는, 스트리밍이 시작 하기 전에, DMO 가 필요로 하는 모든 리소스를 할당한다. FreeStreamingResources 메서드는, 같은 리소스를 릴리즈 한다. 템플릿은, 각각,InternalAllocateStreamingResources 와 InternalFreeStreamingResources 를 호출한다.

DMO 의 클라이언트는 이러한 메서드를 호출할 필요는 없지만, 템플릿은, 스트리밍이 시작 하기 전에 AllocateStreamingResources 를 자동적으로 호출한다. 따라서, DMO 는,ProcessInput 가 불려 간 시점에서는, 리소스를 올바르게 할당할 수 있는 것과 상정해 상관없다. DMO 는, 소멸자 중(안)에서 FreeStreamingResources 를 호출해야 한다.

또, 템플릿은,InternalAllocateStreamingResources 를 호출하면 내부 플래그를 설정해,InternalFreeStreamingResources 를 호출할 때까지는 InternalAllocateStreamingResources 를 다시 호출하지 않게 한다. 이것에 의해, 메모리 누수의 원인이 되는 리소스의 재할인 맞히고가, 잘못해 행해지지 않게 된다.

스트리밍용의 메서드

이하의 메서드는, 데이터를 스트리밍 하기 위해서 사용된다.

• GetInputStatus. 이 메서드는, 그 시점에서 DMO 가 입력을 받아들여질지 어떨지를 나타낸다. 템플릿은, 상속 클래스의 InternalAcceptingInput 를 호출한다. DMO 가 입력을 받아들여지는 경우, 상속 클래스는 S_OK 를 돌려주어, 템플릿은 dwFlags 파라미터의 DMO_INPUT_STATUSF_ACCEPT_DATA 비트를 세트 한다. 입력이 받아들여지지 않는 경우, 상속 클래스는 S_FALSE 를 돌려주어, 템플릿은 dwFlags 를 0 으로 설정한다.
• ProcessInput. 이 메서드는, 입력 버퍼의 처리를 실시한다. 템플릿은, 이미 설명한 AllocateStreamingResources 를 호출한다. 그 후, 상속 클래스의 InternalAcceptingInput 를 호출한다. DMO 가 새로운 입력을 받아들여지는 경우, 템플릿은 InternalProcessInput 를 호출한다.
• ProcessOutput. 이 메서드는, 출력 스트림 마다 1 개씩 있는 출력 버퍼세트를 처리한다. 템플릿은,AllocateStreamingResources 를 호출한 후,InternalProcessOutput 를 호출한다.
• Discontinuity. 이 메서드는, 입력 스트림에 있어서의 불연속을 통지한다. 템플릿은, 상속 클래스의 InternalAcceptingInput 를 호출한다. 이 메서드가 S_OK 를 돌려주었을 경우, 템플릿은 상속 클래스의 InternalDiscontinuity 를 호출한다.
• Flush. 이 메서드는 DMO 를 플래시 한다. 템플릿은, 상속 클래스의 InternalFlush 를 호출한다. DMO 는, 처리를 실시하기 위해서(때문에) 아직 보관 유지하고 있는 입력 버퍼를 파기해야 한다.

템플릿에서는,IMediaObjectInPlace 인터페이스의 직접적인 지원은 제공되지 않다.

락용의 메서드

락은, multi-thread 환경에 있어 DMO 상태를 보호하기 위해서 사용된다. ATL 프로젝트에서는,IMediaObject::Lock 메서드를 사용하면 ATL 의 Lock 메서드와의 사이에 이름의 경합이 발생한다. 이 경합을 해결하기 위해서, 템플릿에서는 IMediaObject 의 메서드의 이름이 DMOLock 로 변경되고 있다. 상속 클래스를 컴파일 할 때는, Dmo.h 헤더 파일을 인클루드 하기 전에 FIX_LOCK_NAME 를 정의할 필요가 있다.

#define FIX_LOCK_NAME
#include <dmo.h>

이 유사 명령이 있으면 프리프로세서는,IMediaObject 인터페이스의 선언에 있는 Lock 를 DMOLock 에 옮겨놓는다. 다만, vtable 순서는 변함없기 때문에, 애플리케이션에서는 Lock 라는 이름을 사용해 메서드를 기동할 수 있다. DMOLock 메서드는, 상속 클래스의 Lock 와 Unlock 를 호출한다. ATL 를 사용해 상속 클래스를 처리 하고 있는 경우는, ATL 가 이러한 메서드를 이미 정의하고 있기 (위해)때문에, 코드를 추가할 필요는 없다. ATL 를 사용하지 않은 경우는, 상속 클래스 중(안)에서 Lock 메서드와 Unlock 메서드를 제공할 필요가 있다.

템플릿은,IMediaObject 의 각 메서드 중(안)에서 DMO 를 자동적으로 잠근다. 상속 클래스에서는, 처리 하고 있는 다른 퍼블릭 메서드 (IMediaObjectInPlace 를 지원 하고 있는 경우등) 중(안)에서, DMO 를 잠그는 것이 필요한 경우가 있다. 클래스 템플릿은, 내부 헬퍼-클래스 IMediaObjectImpl::LockIt 도 제공하고 있다. 이 클래스는, DMO 를 잠금 및 잠금 해제할 때에 도움이 된다.

통계

이하의 IMediaObject 메서드에 대해, 템플릿은, 상속 클래스상에서 같은 서명의 대응하는 메서드를 호출한다. 상속 클래스에서는, 2 번째의 열로 나타나고 있는 각 메서드를 처리 할 필요가 있다.

IMediaObject 의 나머지의 메서드에 대해서는, 템플릿의 메서드와 상속 클래스의 메서드가 1 대 1 에 대응하고 있지 않다. 다음의 일람은, 템플릿으로 완전하게 처리 되는 메서드와 상속 클래스의 다른 메서드를 호출하는 메서드를 집계한 것이다.

참조

• IMediaObjectImpl 클래스 템플릿