Windows 스토어 장치 앱에 대한 카메라 Driver MFT 만들기

Windows 8.1에서는 Windows 스토어 장치 앱을 통해 카메라 Driver MFT(Media Foundation Transform)를 사용하여 장치 제조업체에서 사용자 지정 설정과 특수 효과를 카메라 동영상 스트림에 적용할 수 있습니다. 이 항목에서는 Driver MFT를 소개하고 Driver MFT 샘플을 사용하여 Driver MFT를 만드는 방법을 보여 줍니다. 일반적인 Windows 스토어 장치 앱에 대한 자세한 내용은 Windows 스토어 장치 앱 알아보기를 참조하세요.

Driver MFT

이 섹션에서는 카메라에서 오는 미디어 캡처 스트림에 효과를 적용하기 위해 만드는 MFT(Media Foundation Transform)에 대해 설명합니다. 이것은 자신의 카메라를 다른 카메라와 확실히 차별화하는 색 효과, 색상표 모드 및 얼굴 추적 효과를 위한 변형을 제공하는 방법입니다. Driver MFT라고도 하는 이 MFT는 Windows 스토어 앱이 동영상 캡처를 시작할 때 카메라 드라이버에서 오는 연결된 동영상 스트림에 처음 적용됩니다. 앱이 카메라 옵션을 호출하면, Windows는 사용자 지정 효과 제어를 위해 Driver MFT가 구현하는 인터페이스에 대한 액세스를 자동으로 제공합니다.

카메라 Driver MFT는 Windows 스토어 장치 앱에서 사용자 지정 효과를 제공할 때 유용합니다.

Windows 스토어 장치 앱에는 Driver MFT가 필요하지 않습니다. 동영상 스트림에 사용자 지정 설정과 특수 효과를 적용하지 않고 자사 하드웨어의 브랜딩을 포함하는 차별화된 사용자 인터페이스만 제공하려는 경우, 장치 제조업체는 Driver MFT 없이 Windows 스토어 장치 앱을 구현할 수 있습니다.

Driver MFT를 사용하는 방법

카메라용 Windows 스토어 장치 앱은 CameraCaptureUI API에서 호출하는 Windows 스토어 앱과는 다른 프로세스에서 실행됩니다. Windows 스토어 장치 앱이 Driver MFT를 제어하려면 이벤트가 여러 프로세스 공간에 걸쳐 특정 순서로 발생해야 합니다.

  1. Windows 스토어 앱은 사진을 캡처하기 위해 CaptureFileAsync 메서드를 호출합니다.
  2. Windows는 Driver MFT 포인터 및 카메라의 장치 ID를 요청합니다.
  3. Driver MFT 포인터가 설정 호스트에 전달됩니다.
  4. 호스트는 장치 메타데이터별로 카메라와 연결된 Windows 스토어 장치 앱의 앱 ID에 대한 장치 속성을 쿼리합니다.
  5. Windows 스토어 장치 앱을 찾을 수 없으면 기본 플라이아웃이 캡처 엔진을 조작합니다.
  6. Windows 스토어 장치 앱이 발견되면 해당 앱이 활성화되고 설정 호스트가 Driver MFT 포인터를 앱에 전달합니다.
  7. Windows 스토어 장치 앱은 포인터를 통해 노출된 인터페이스를 사용하여 Driver MFT를 제어합니다.

Windows 스토어 장치 앱을 호출하는 프로세스 상호 작용입니다.

AvStream 드라이버 모델 요구 사항

카메라 드라이버는 AvStream 드라이버 모델을 사용해야 합니다. AVStream 드라이버 모델에 대한 자세한 내용은 AVStream 미니 드라이버 디자인 지침을 참조하세요.

Driver MFT가 앱에 노출되는 방식

Driver MFT는, 구현하는 변형이 카메라와 같은 특정 장치에서 오는 동영상 스트림에 적용될 수 있도록 Windows에 COM 인터페이스로서 등록됩니다.

참고  Driver MFT는 장치 전용이며 범용 MFT가 아니므로 MFTRegister 함수를 사용하여 등록해서는 안 됩니다. 레지스트리 키에 대한 자세한 내용은 이 항목의 뒷부분에 있는 Driver MFT 설치 및 등록 섹션을 참조하세요.

앱이 비디오 캡처를 시작하면 비디오 스트림을 제공하기 위해 Media Foundation 소스 뷰어가 인스턴스화됩니다. 이 미디어 소스는 장치 레지스트리 키에서 레지스트리 값을 읽습니다. Driver MFT COM 클래스의 CLSID가 레지스트리 값에서 발견되면 소스 뷰어는 Driver MFT를 인스턴스화하고 미디어 파이프라인에 삽입합니다.

다음 API를 사용해 관련 장치로 동영상을 캡처하는 경우 Windows 스토어 장치 앱 외에 Driver MFT 기능에도 액세스할 수 있습니다.

  • HTML로 작성된 Windows 스토어 앱의 HTML5 <video> 태그. Driver MFT를 통해 사용되는 변형은, 다음 코드 예제와 같이 <video> 요소를 사용해 재생되는 동영상에 영향을 미칩니다.

    
    var video = document.getElementById('myvideo');
            video.src = URL.createObjectURL(fileItem);
            video.play();
    
    
    
  • Windows 런타임으로 작성된 Windows 스토어 앱의 Windows.Media.MediaCapture API. 이 API의 사용 방법에 대한 자세한 내용은 미디어 캡처 샘플을 참조하세요.

  • 앱에서 미디어 데이터를 처리하기 위한 Media Foundation의 소스 뷰어. IMFSourceReaderEx::GetTransformForStream을 호출하면 Driver MFT가 첫 번째(0번째) MFT로서 응용 프로그램에 노출됩니다. 반환될 범주는 MFT_CATEGORY_VIDEO_EFFECT입니다.

    미디어 캡처에서 소스 뷰어의 역할입니다.

멀티핀 카메라

3핀 또는 기타 다중 핀 카메라가 있는 경우 다중 핀 카메라의 Driver MFT 관련 고려 사항을 참조하세요.

Driver MFT 구현

이 섹션에서는 Driver MFT 구현에 대한 정보를 제공합니다. Windows 스토어 장치 앱과 작동하는 Driver MFT의 전체 예제는 Driver MFT 샘플을 참조하세요.

개발 도구

Microsoft Visual Studio Professional 2013 또는 Microsoft Visual Studio Ultimate 2013이 필요합니다.

Driver MFT 특성

Driver MFT는 스트림 단위로 인스턴스화됩니다. 카메라가 지원하는 각 스트림에 대해 MFT의 인스턴스가 인스턴스화되고 연결됩니다. Driver MFT는 단일 입력 스트림 및 단일 출력 스트림을 갖게 됩니다. Driver MFT는 동기 MFT 또는 비동기 MFT일 수 있습니다.

카메라와 Driver MFT 간 통신

미디어 소스와 Driver MFT 간 양방향 통신을 가능하게 하려면, 소스 스트림의 특성 저장소에 대한 포인터를 MFT_CONNECTED_STREAM_ATTRIBUTE와 같은 Driver MFT의 입력 스트림 특성 저장소에 설정해야 합니다. 이는 다음 예와 같이, Driver MFT에서 MFT_ENUM_HARDWARE_URL_Attribute를 노출하여 활성화하는 핸드셰이크 프로세스를 통해 발생합니다.


HRESULT CDriverMft::GetAttributes(IMFAttributes** ppAttributes)
{
    HRESULT hr = S_OK;
    if (NULL == ppAttributes)
    {
       return E_POINTER; 
    };
        if(!m_pGlobalAttributes) {
           MFCreateAttributes(&m_pGlobalAttributes, 1);
           m_pGlobalAttributes-> 
             SetString(MFT_ENUM_HARDWARE_URL_Attribute, L"driverMFT");
        }
        *ppAttributes = m_pGlobalAttributes;
        (*ppAttributes)->AddRef();
        return S_OK;
}


이 예제에서 Driver MFT 특성 저장소의 MFT_CONNECTED_STREAM_ATTRIBUTE 는 장치 소스 스트림의 특성 저장소를 가리키도록 설정됩니다. 카메라와 MFT 간 통신 설정 방법에 대한 자세한 내용은 Hardware Handshake Sequence(하드웨어 핸드셰이크 시퀀스)를 참조하세요.

장치 소스 정보에 액세스하는 방법

다음 코드 예제는 Driver MFT가 입력 특성 저장소에서 소스 변형에 대한 포인터를 가져오는 방법을 보여 줍니다. Driver MFT는 소스 포인터를 사용해 장치 소스 정보를 가져올 수 있습니다.


if(!m_pSourceTransform && m_pInputAttributes) {
          
          m_pInputAttributes->
              GetUnknown( MFT_CONNECTED_STREAM_ATTRIBUTE,
              IID_PPV_ARGS(&pSourceAttributes));
          pSourceAttributes-> 
              GetUnknown(
              MF_DEVICESTREAM_EXTENSION_PLUGIN_CONNECTION_POINT,            
              IID_PPV_ARGS(&pUnk)));
          pUnk->QueryInterface(__uuidof(IMFTransform), 
              (void**)&m_pSourceTransform));
      }
      if (m_pSourceTransform) {
         // Put code to get device source information here.         
      }


통과 모드를 구현하는 방법

Driver MFT를 통과 모드에 두려면 입력 및 출력 스트림에 대해 동일한 미디어 유형을 지정합니다. MFT에 대한 ProcessInputProcessOutput 호출은 계속 사용할 수 있습니다. 통과 모드에서 프로세싱의 발생 여부를 결정하는 것은 Driver MFT 구현에 달려 있습니다.

포함할 헤더 파일

Driver MFT가 구현해야 할 IInspectableIMFTransform 메서드에 대한 헤더 파일을 포함해야 합니다. 포함할 헤더 파일 목록은 카메라용 Windows 스토어 장치 앱 샘플의 SampleMFT0 디렉터리에 있는 stdafx.h를 참조하세요.


// required for IInspectable
#include <inspectable.h>


IInspectable을 구현하는 방법

Windows 스토어 장치 앱이 시작 시 Driver MFT에 대한 포인터에 액세스할 수 있도록 하려면, 카메라의 Windows 스토어 장치 앱에서 사용할 Driver MFT에서 IInspectable의 메서드를 구현해야 합니다. Driver MFT는 다음과 같이 IInspectable의 메서드를 구현해야 합니다.

  • IInspectable::GetIidsiids out 매개 변수에서 null을, iidCount out 매개 변수에서 0을 반환해야 합니다.

  • IInspectable::GetRuntimeClassName은 out 매개 변수에서 null을 반환해야 합니다.

  • IInspectable::GetRuntiGetTrustLevel은 out 매개 변수에서 TrustLevel::BaseTrust를 반환해야 합니다.

다음 코드 예제는 샘플 Driver MFT에서 IInspectable 메서드를 구현하는 방법을 보여 줍니다. 이 코드는 샘플의 SampleMFT0 디렉터리에 있는 Mft0.cpp 파일에서 찾을 수 있습니다.


// Mft0.cpp
STDMETHODIMP CMft0::GetIids( 
    /* [out] */ __RPC__out ULONG *iidCount,
    /* [size_is][size_is][out] */ __RPC__deref_out_ecount_full_opt(*iidCount) IID **iids)
{
    HRESULT hr = S_OK;
    do {
        CHK_NULL_PTR_BRK(iidCount);
        CHK_NULL_PTR_BRK(iids);
        *iids = NULL;
        *iidCount = 0;
    } while (FALSE);

    return hr;
}

STDMETHODIMP CMft0::GetRuntimeClassName( 
    /* [out] */ __RPC__deref_out_opt HSTRING *className)
{
    HRESULT hr = S_OK;
    do {
        CHK_NULL_PTR_BRK(className);
        *className = NULL;
    } while (FALSE);

    return hr;
}

STDMETHODIMP CMft0::GetTrustLevel( 
    /* [out] */ __RPC__out TrustLevel *trustLevel)
{
    HRESULT hr = S_OK;
    do {
        CHK_NULL_PTR_BRK(trustLevel);
        *trustLevel = TrustLevel::BaseTrust;
    } while (FALSE);

    return hr;
}


COM 구현

Driver MFT에서 구현하는 각 인터페이스는 IUnknown에서 구현 및 파생되어야만 카메라의 Windows 스토어 장치 앱에 올바르게 마샬링됩니다. 다음은 이를 보여 주는 Driver MFT의 .idl 파일 예제입니다.


// SampleMft0.idl : IDL source for SampleMft0
//

// This file will be processed by the MIDL tool to
// produce the type library (SampleMft0.tlb) and marshalling code.

import "oaidl.idl";
import "ocidl.idl";
import "Inspectable.idl";
import "mftransform.idl";
[
    object,
    uuid(F5208B72-A37A-457E-A309-AE3060780E21),
    oleautomation,
    nonextensible,
    pointer_default(unique)
]
interface IMft0 : IUnknown{
    [id(1)] HRESULT UpdateDsp([in] UINT32 uiPercentOfScreen);
    [id(2)] HRESULT Enable(void);
    [id(3)] HRESULT Disable(void);
    [id(4)] HRESULT GetDspSetting([out] UINT* puiPercentOfScreen, [out] BOOL* pIsEnabled);
};
[
    uuid(DE05674A-C564-4C0E-9B7C-E1519F7AA767),
    version(1.0),
]
library SampleMft0Lib
{
    importlib("stdole2.tlb");
    [
        uuid(7BB640D9-33A4-4759-B290-F41A31DCF848)		
    ]
    coclass Mft0
    {
        [default] interface IMft0;
        interface IInspectable;
        interface IMFTransform;
    };
};


참고  Driver MFT는 CoCreateInstance를 사용해 만들 수 있는 일반 COM 클래스입니다. 범용 MFT 가 아니므로 MFTRegister 함수를 사용하여 등록해서는 안 됩니다.

프록시 만들기

Driver MFT는 Out Of Process 서버입니다. 이를 Windows 스토어 장치 앱에서 사용하려면 프록시에서 마샬링 지원을 제공해야 합니다. 그래야만 프로세스 경계를 넘어 Driver MFT 인터페이스를 사용할 수 있습니다. Driver MFT 샘플에서 이에 대한 예를 볼 수 있습니다. 이 샘플은 MIDL 컴파일러를 사용해 스텁 없는 프록시를 생성합니다.

Driver MFT를 앱에 노출

Driver MFT와 상호 작용하는 Windows 스토어 장치 앱을 C# 또는 JavaScript로 작성하려면, Windows 스토어 장치 앱의 Microsoft Visual Studio 프로젝트에서 추가 구성 요소를 만들어야 합니다. 이 구성 요소는 Windows 스토어 장치 앱에 보이는 Windows 런타임 구성 요소에서 Driver MFT 인터페이스를 노출하는 래퍼입니다.

카메라용 Windows 스토어 장치 앱 샘플의 래퍼 하위 프로젝트는 Windows 런타임에 Driver MFT를 노출하는 방법의 예제를 제공합니다. C# 또는 JavaScript로 구현된 Windows 스토어 장치 앱에서 이를 사용할 수 있습니다. 이것은 Driver MFT 샘플과 작동하도록 설계되었습니다. 샘플을 설치, 실행 및 테스트하기 위한 단계별 지침은 Driver MFT 샘플 페이지를 참조하세요.

Driver MFT 설치 및 등록

이 섹션에서는 Driver MFT를 설치하기 위한 단계를 제공합니다.

  1. 다음 중 하나의 하위 디렉터리에 Driver MFT DLL을 설치해야 합니다.
    • %SystemDrive%\Program Files\
    • %SystemDrive%\Program Files (x86)\
  2. x64 시스템에서는 x86 및 x64 DLL 버전을 모두 설치합니다.
  3. 카메라 설치 프로그램은 Driver MFT DLL에서 regsvr32를 호출하거나 설치 프로그램에서 등록에 사용하는 드라이버 매니페스트(.man) 파일을 제공하여 Driver MFT를 등록합니다.
  4. 카메라의 레지스트리 키에서 CameraPostProcessingPluginCLSID 값을 설정합니다. INF 파일은 CameraPostProcessingPluginCLSID 값을 Driver MFT의 CLSID GUID로 설정하여 장치에 대한 장치 클래스 레지스트리 키에서 Driver MFT의 CLSID를 지정해야 합니다. 다음은 카메라에 대한 레지스트리 키를 채우는 INF 파일 항목의 예입니다.
    
    KSCATEGORY_VIDEO_CAMERA:
    
    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\DeviceClasses\{E5323777-F976-4f5b-9B55-B94699C46E44}\##?#USB#VID_045E&PID_075D&MI_00#8&23C3DB65&0&0000#{E5323777-F976-4f5b-9B55-B94699C46E44}\#GLOBAL\Device Parameters]
    "CLSID"="{17CCA71B-ECD7-11D0-B908-00A0C9223196}"
    "FriendlyName"="USB Video Device"
    "RTCFlags"=dword:00000010
    "CameraPostProcessingPluginCLSID"="{3456A71B-ECD7-11D0-B908-00A0C9223196}" 
    
    
    KSCATEGORY_CAPTURE:
    
    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\DeviceClasses\{ 65E8773D-8F56-11D0-A3B9-00A0C9223196}\##?#USB#VID_045E&PID_075D&MI_00#8&23C3DB65&0&0000#{65E8773D-8F56-11D0-A3B9-00A0C9223196}\#GLOBAL\Device Parameters]
    "CLSID"="{17CCA71B-ECD7-11D0-B908-00A0C9223196}"
    "FriendlyName"="USB Video Device"
    "RTCFlags"=dword:00000010
    "CameraPostProcessingPluginCLSID"="{3456A71B-ECD7-11D0-B908-00A0C9223196}"
    
    
    

    참고  KSCATEGORY_VIDEO_CAMERA는 카메라에 권장됩니다. 장치의 등록 방식에 따라 일반적으로 레지스트리 키 중 하나만 필요합니다.

앱을 카메라와 연결

이 섹션에서는 장치 메타데이터 및 Windows 레지스트리에서 카메라를 식별하는 데 필요한 단계에 대한 정보를 제공합니다. 이 메타데이터를 사용하면 Windows 스토어 장치 앱을 페어링할 수 있으며, 카메라를 처음 연결할 때 원활하게 다운로드할 수 있도록 앱을 식별할 수 있습니다.

업데이트

앱을 처음 설치한 이후 사용자가 앱의 업데이트된 버전을 다운로드하는 경우, 카메라 캡처 환경에 업데이트가 자동으로 통합됩니다. 그러나 업데이트는 자동으로 다운로드되지 않습니다. 사용자가 Windows 스토어에서 추가 앱 업데이트를 다운로드해야 합니다. 앱은 카메라를 처음 연결할 때만 자동으로 설치되기 때문입니다. Windows 스토어 장치 앱의 기본 페이지에서는 업데이트가 사용 가능하다는 알림과 업데이트를 다운로드하기 위한 링크를 제공할 수 있습니다.

중요  업데이트된 앱은 Windows 업데이트를 통해 배포되는 업데이트된 드라이버와 작동해야 합니다.

여러 카메라

여러 카메라 모델이 장치 메타데이터에서 동일한 Windows 스토어 장치 앱을 선언할 수 있습니다. 내장 카메라가 시스템에 두 개 이상 있는 경우 각 카메라는 동일한 Windows 스토어 장치 앱을 공유해야 합니다. 앱은 사용 중인 카메라를 확인하기 위한 논리를 포함하며, 기타 옵션 환경에서 각 카메라에 대해 다른 UI를 표시할 수 있습니다. 해당 환경을 사용자 지정하는 방법에 대한 자세한 내용은 카메라 옵션을 사용자 지정하는 방법을 참조하세요.

내부 카메라

내부 카메라용 Windows 스토어 장치 앱은 Windows 스토어에서 자동 설치도 가능하지만, 가장 능률적인 사용자 환경을 위해 미리 설치하는 것이 좋습니다. 내부 카메라를 지원하고 Windows 스토어 장치 앱과 내부 카메라를 연결하려면 추가 단계가 필요합니다. 자세한 내용은 내부 카메라 위치 식별을 참조하세요.

장치 메타데이터 패키지 만들기

내부 및 외부 카메라 모두에 대해 장치 메타데이터 패키지를 만들어야 합니다. 카메라의 Windows 스토어 장치 앱을 Windows 스토어에 제출할 때(또는 내부 카메라의 경우 OPK를 사용해 사전 설치할 때) 앱 자체 외에도 다음을 포함하는 메타데이터를 제공해야 합니다.

  • 응용 프로그램 게시자 이름
  • 응용 프로그램 패키지 이름
  • 응용 프로그램 요소 식별자
  • 장치 환경 식별자

장치 메타데이터를 사용하여 앱을 장치와 연결하는 방법에 대한 자세한 내용은 Windows 스토어 장치 앱 빌드를 참조하세요.

관련 항목

Windows 스토어 장치 앱 빌드
Windows 스토어 장치 앱의 자동 설치
하드웨어 핸드셰이크 순서(하드웨어 MFT)
AVStream 미니 드라이버 디자인 지침
카메라 샘플용 Windows 스토어 장치 앱
Driver MFT 샘플

 

 

표시:
© 2014 Microsoft