DirectShow 필터의 빌드

DirectShow 필터의 처리에는 DirectShow base class를 사용하는 것을 추천 한다. base class를 사용해 빌드 하려면 , 「빌드 환경의 설정」으로 설명하고 있는 순서에 가세해 다음의 순서를 실행한다.

base class 라이브러리를 빌드 한다. 이 라이브러리는, SDK 루트 디렉토리아래에 있는 Samples\Multimedia\C++\BaseClasses 디렉토리에 놓여져 있다. 이 라이브러리에는, 2 개의 버전이 있다. 리테일 버전 (Strmbased.lib)과 디버그 버전 (Strmbasd.lib)이다.
헤더 파일 Streams.h 를 인클루드 한다.
__stdcall 호출 규칙을 사용한다.
multi-thread의 C 런 타임 라이브러리 (필요에 따라서 디버그 버전 또는 리테일 버전)를 사용한다.

DLL 함수를 export 하는 정의 파일 (. def)를 인클루드 한다. 정의 파일의 예를 다음에 나타낸다. 출력 파일의 이름은 MyFilter.dll 이라고 상정한다.

LIBRARY MYFILTER.DLL
EXPORTS 
    DllMain             PRIVATE
    DllGetClassObject   PRIVATE
    DllCanUnloadNow     PRIVATE
    DllRegisterServer   PRIVATE
    DllUnregisterServer PRIVATE

다음의 lib 파일에 링크한다.

디버그 빌드 Strmbasd.lib, Msvcrtd.lib, Winmm.lib

리테일 빌드 Strmbase.lib, Msvcrt.lib, Winmm.lib
링커의 설정으로 [디폴트 라이브러리를 무시] 옵션을 선택한다.

소스 코드의 DLL 엔트리 포인트를 이하대로 선언한다.

extern "C" BOOL WINAPI DllEntryPoint(HINSTANCE, ULONG, LPVOID);
BOOL APIENTRY DllMain(HANDLE hModule, DWORD dwReason, LPVOID lpReserved)
{
    return DllEntryPoint((HINSTANCE)(hModule), dwReason, lpReserved);
}

이전의 버전

DirectShow 9.0 보다 전의 base class 라이브러리의 버전에서는, 다음의 처리도 실시할 필요가 있다.

디버그 빌드에서는, 프리프로세서 플래그 DEBUG 를 정의한다.

이 순서는, DirectShow 9.0 이후에 이용할 수 있는 base class 라이브러리의 버전에서는 필요없다.

참조

DirectShow base class

↑TOP

디버그 빌드	Strmbasd.lib, Msvcrtd.lib, Winmm.lib
리테일 빌드	Strmbase.lib, Msvcrt.lib, Winmm.lib