Microsoft MVP성태의 닷넷 이야기
닷넷: 2253. C# - Video Capture 장치(Camera) 열거 및 지원 포맷 조회 [링크 복사], [링크+제목 복사],
조회: 1906
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 1개 있습니다.)

C# - Video Capture 장치(Camera) 열거 및 지원 포맷 조회

기왕에 Microsoft Media Foundation의 PInvoke 호출까지 알아봤으니,

C# - 인터페이스 타입의 다중 포인터를 인자로 갖는 C/C++ 함수 연동
; https://www.sysnet.pe.kr/2/0/13607

아래 문서에 나오는 예제를 C#으로 완성해 보겠습니다. ^^

Enumerating Video Capture Devices
; https://learn.microsoft.com/en-us/windows/win32/medfound/enumerating-video-capture-devices

How to Set the Video Capture Format
; https://learn.microsoft.com/en-us/windows/win32/medfound/how-to-set-the-video-capture-format

우선, Video 장치의 수를 먼저 알아볼 텐데요, 관련 COM 인터페이스만 적절하게 정의를 맞춰주면 다음과 같이 구할 수 있습니다.

public static unsafe uint GetVideoDeviceCount()
{
    uint pcSourceActivate = 0;

    IMFAttributes? pAttributes = null;
    IMFActivate[]? ppDevices = null;

    // 1. IMFAttributes 개체를 구해,
    NativeMethods.MFCreateAttributes(out pAttributes, 1);

    try
    {
        // 2. Video 장치로 대상을 설정하고, 
        pAttributes.SetGuid(MFGuid.MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_GUID, MFGuid.MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_GUID);

        // 3. 장치에 대응하는 IMFActivate 인스턴스 배열을 구함 (pcSourceActivate가 장치의 개수를 의미)
        NativeMethods.MFEnumDeviceSources(pAttributes, out ppDevices, out pcSourceActivate);
    }
    finally
    {
        // 자원 해제
        if (ppDevices != null)
        {
            for (uint i = 0; i < pcSourceActivate; i++)
            {
                Marshal.ReleaseComObject(ppDevices[i]);
            }
        }

        if (pAttributes != null)
        {
            Marshal.ReleaseComObject(pAttributes);
        }
    }

    return pcSourceActivate;
}

설치한 비디오 Camera 수를 알았으면 이제 인덱스 별로 장치에 대한 IMFMediaSource 인터페이스를 구할 수 있습니다.

// Enumerating Video Capture Devices
// ; https://learn.microsoft.com/en-us/windows/win32/medfound/enumerating-video-capture-devices

uint captureDeviceCount = GetVideoDeviceCount();

for (int i = 0; i < captureDeviceCount; i++)
{
    IMFMediaSource mediaSource = GetMediaSource(i, out string symbolicLink, out string deviceName);

    // ... Video Camera에 대한 mediaSource 인터페이스 사용
}

public static IMFMediaSource GetMediaSource(int deviceIndex, out string symbolicLink, out string deviceName)
{
    IMFAttributes? pAttributes = null;
    IMFActivate[]? ppDevices = null;
    IMFMediaSource? pSource = null;
    uint pcSourceActivate = 0;
    symbolicLink = string.Empty;

    // 1. GetVideoDeviceCount 메서드에서 썼던 코드를 재사용, 즉, 연결 중인 Video 장치를 모두 가져와서,
    NativeMethods.MFCreateAttributes(out pAttributes, 1);

    try
    {
        pAttributes.SetGuid(MFGuid.MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_GUID, MFGuid.MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_GUID);
        NativeMethods.MFEnumDeviceSources(pAttributes, out ppDevices, out pcSourceActivate);

        if (deviceIndex >= pcSourceActivate)
        {
            throw new ArgumentOutOfRangeException($"MediaDevices[{nameof(deviceIndex)}]");
        }

        // 2. 그 장치 목록 배열에서 deviceIndex를 지정한 장치의 정보를 조회
        ppDevices[deviceIndex].GetAllocatedString(MFGuid.MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK_GUID,
            out symbolicLink, out _);

        ppDevices[deviceIndex].GetAllocatedString(MFGuid.MF_DEVSOURCE_ATTRIBUTE_FRIENDLY_NAME, out deviceName, out _);

        // 3. 해당 장치의 IMFMediaSource 인터페이스를 반환
        ppDevices[deviceIndex].ActivateObject(typeof(IMFMediaSource).GUID, out pSource);
    }
    finally
    {
        if (ppDevices != null)
        {
            for (uint i = 0; i < pcSourceActivate; i++)
            {
                Marshal.ReleaseComObject(ppDevices[i]);
            }
        }

        if (pAttributes != null)
        {
            Marshal.ReleaseComObject(pAttributes);
        }
    }

    return pSource;
}

참고로, 위에서 구한 symbolicLink, deviceName을 출력해 보면 이런 식으로 나옵니다.

symbolicLink: \\?\USB#VID_046D&...[생략]...\{bbefb6c7-...[생략]...724083}: 
deviceName: HD Pro Webcam C920

그러고 보니 언젠가 이와 유사한 정보를 구했던 것 같습니다. ^^

데스크톱 윈도우 응용 프로그램에서 UWP 라이브러리를 이용한 비디오 장치 열람하는 방법
; https://www.sysnet.pe.kr/2/0/11284

위의 글에서 "DeviceInformation.FindAllAsync(DeviceClass.VideoCapture);" 코드로 구했던 DeviceInformation 타입의 Id와 Name이 정확히 그 값에 해당합니다.




마지막으로, IMFMediaSource를 구했으면 이제 그 장치에 대한 정보를 조회할 수 있습니다. 일례로 해당 장치가 지원하고 있는 Capture Format을 열거하는 것이 가능한데요, 대충 다음과 같은 코드로 가능합니다.

// How to Set the Video Capture Format
// ; https://learn.microsoft.com/en-us/windows/win32/medfound/how-to-set-the-video-capture-format

internal static void GetCaptureFormats(IMFMediaSource pSource)
{
    IMFPresentationDescriptor? pPD = null;
    IMFStreamDescriptor? pSD = null;
    IMFMediaTypeHandler? pHandler = null;

    try
    {
        pSource.CreatePresentationDescriptor(out pPD);
        pPD.GetStreamDescriptorByIndex(0, out bool pfSelected, out pSD);
        pSD.GetMediaTypeHandler(out pHandler);

        // 1. 장치에서 지원하는 Capture Format 수를 구하고,
        pHandler.GetMediaTypeCount(out uint cTypes);

        // 2. 해당 Capture Format을 구성하는 속성들을 조회할 수 있는 IMFMediaType을 가져와,
        for (uint i = 0; i < cTypes; i++)
        {
            pHandler.GetMediaTypeByIndex(i, out IMFMediaType ppType);

            try
            {
                // 3. Capture Format을 설명하는 각각의 값을 출력
                DebugLogMediaType(ppType);
            }
            finally
            {
                if (ppType != null)
                {
                    Marshal.ReleaseComObject(ppType);
                }
            }
        }
    }
    finally
    {
        if (pPD != null)
        {
            Marshal.ReleaseComObject(pPD);
        }

        if (pSD != null)
        {
            Marshal.ReleaseComObject(pSD);
        }

        if (pHandler != null)
        {
            Marshal.ReleaseComObject(pHandler);
        }
    }
}

여기서 좀 난관이 있는데요, IMFMediaType으로 조회하는 필드의 값 타입이 PropVariant이므로,

PROPVARIANT structure (propidlbase.h)
; https://learn.microsoft.com/en-us/windows/win32/api/propidlbase/ns-propidlbase-propvariant

직접 만들기 귀찮으니 PropVariant를 감싼 적절한 소스코드를 찾아,

Programming/C#/Windows API Code Pack 1.1/source/WindowsAPICodePack/Core/PropertySystem
; https://github.com/jlnewton87/Programming/blob/master/C%23/Windows%20API%20Code%20Pack%201.1/source/WindowsAPICodePack/Core/PropertySystem/PropVariant.cs

활용하면 이런 식으로 DebugLogMediaType 코드를 작성할 수 있습니다.

private static void DebugLogMediaType(IMFMediaType pType)
{
    uint count = 0;

    // 1. Capture Format을 구성하는 필드의 수를 반환
    pType.GetCount(out count);

    // 2. 개별 필드에 대한 값을 구해 출력
    for (uint i = 0; i < count; i ++)
    {
        IMFAttributes pAttr = pType as IMFAttributes;
        DebugLogAttributeValueByIndex(pAttr, i);
    }
}

private static void DebugLogAttributeValueByIndex(IMFAttributes pAttr, uint i)
{
    PropVariant var = new PropVariant();
    pAttr.GetItemByIndex(i, out Guid guid, var);

    string guidName = MFGuid.GetName(guid);

    Console.Write($"{guidName}: ");
    SpecialCaseAttributeValue(guid, var);

    if (hr == HRESULT.S_FALSE)
    {
        switch (var.VarType)
        {
            case VarEnum.VT_UI4:
            case VarEnum.VT_R8:
                Console.Write(var.Value);
                break;

            case VarEnum.VT_CLSID:
                Console.Write(MFGuid.GetName((Guid)var.Value));
                break;

            case VarEnum.VT_LPWSTR:
                Console.Write(var.Value);
                break;

            case VarEnum.VT_VECTOR | VarEnum.VT_UI1:
                Console.Write($"<<byte array>>");
                break;

            case VarEnum.VT_UNKNOWN:
                Console.Write($"IUnknown");
                break;
        }
    }

    Console.WriteLine();
}




테스트해보면, Logitech HD Pro Webcam C920 제품의 경우 573개의 Capture Foramt을 지원하는데요, 개별 포맷에 대한 필드를 보면 이런 출력 결과를 얻을 수 있습니다.

Format: #1
MF_MT_MAJOR_TYPE        MFMediaType_Video
MF_MT_VIDEO_LIGHTING    3
MF_MT_DEFAULT_STRIDE    1600
MF_MT_VIDEO_CHROMA_SITING       6
MF_MT_AM_FORMAT_TYPE    {F72A76A0-EB0A-11D0-ACE4-0000C0CC16BA}
MF_MT_FIXED_SIZE_SAMPLES        1
MF_MT_VIDEO_NOMINAL_RANGE       2
MF_MT_FRAME_RATE        30 x 1
MF_MT_PIXEL_ASPECT_RATIO        1 x 1
MF_MT_ALL_SAMPLES_INDEPENDENT   1
MF_MT_FRAME_RATE_RANGE_MIN      30 x 1
MF_MT_SAMPLE_SIZE       716800
MF_MT_VIDEO_PRIMARIES   2
MF_MT_INTERLACE_MODE    2
MF_MT_FRAME_RATE_RANGE_MAX      30 x 1
MF_MT_SUBTYPE   MFVideoFormat_YUY2

...[생략]...

Format: #573
MF_MT_FRAME_SIZE: 1920 x 1080
MF_MT_AVG_BITRATE: 995328000
MF_MT_YUV_MATRIX: 2
MF_MT_MAJOR_TYPE: MFMediaType_Video
MF_MT_VIDEO_LIGHTING: 3
MF_MT_CHROMA_SITING: 6
MF_MT_AM_FORMAT_TYPE: WAVEFORMAT_VIDEOINFOHEADER2
MF_MT_FIXED_SIZE_SAMPLES: 1
MF_MT_VIDEO_NOMINAL_RANGE: 2
MF_MT_FRAME_RATE: 5 x 1
MF_MT_PIXEL_ASPECT_RATIO: 1 x 1
MF_MT_ALL_SAMPLES_INDEPENDENT: 1
MF_MT_FRAME_RATE_RANGE_MIN: 5 x 1
MF_MT_SAMPLE_SIZE: 4147200
MF_MT_VIDEO_PRIMARIES: 2
MF_MT_INTERLACE_MODE: 2
MF_MT_FRAME_RATE_RANGE_MAX: 5 x 1
MF_MT_SUBTYPE: MFVideoFormat_H264

암튼, 오디오와 비디오 세계는 그동안 쌓인 역사가 오래돼서 그런지 꽤나 복잡한 듯합니다. ^^

첨부 파일은 이 글의 예제 코드를 포함하지만, 기본적인 Interop만 포함하고 있으므로 활용 수준으로는 적합하지 않습니다. 그런 목적으로는 Nuget에 있는 MediaFoundation 패키지가 도움이 될 수 있습니다.

MediaFoundation
; https://www.nuget.org/packages/MediaFoundation




아래의 질문이 갑자기 떠오르는데요,

OpenCV 이용 해상도 설정 질문 입니다..
; https://www.sysnet.pe.kr/3/0/5317

아마도 윈도우 10의 기본 앱에서는 "How to Set the Video Capture Format" 글에 나온 "IMFMediaTypeHandler.SetCurrentMediaType" 함수를 호출해 2560x1440 모드로 설정을 한 것이 아닐까... 하는 예상을 해봅니다. ^^




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 5/1/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13651정성태6/19/2024300닷넷: 2266. C# - (Reflection 없이) DLL AssemblyFileVersion 구하는 방법파일 다운로드1
13650정성태6/18/2024265개발 환경 구성: 713. "WSL --debug-shell"로 살펴보는 WSL 2 VM의 리눅스 환경
13649정성태6/18/2024266오류 유형: 910. windbg - !py 확장 명령어 실행 시 "failed to find python interpreter" (2)
13648정성태6/17/2024278오류 유형: 909. C# - DynamicMethod 사용 시 System.TypeAccessException
13647정성태6/16/2024434개발 환경 구성: 712. Windows - WSL 2의 네트워크 통신 방법 - 세 번째 이야기 (같은 IP를 공유하는 WSL 2 인스턴스)
13646정성태6/14/2024464오류 유형: 908. Process Explorer - "Error configuring dump resources: The system cannot find the file specified."
13645정성태6/13/2024800개발 환경 구성: 711. Visual Studio로 개발 시 기본 등록하는 dev tag 이미지로 Docker Desktop k8s에서 실행하는 방법
13644정성태6/12/2024808닷넷: 2265. C# - System.Text.Json의 기본적인 (한글 등에서의) escape 처리
13643정성태6/12/2024916오류 유형: 907. MySqlConnector 사용 시 System.IO.FileLoadException 오류
13642정성태6/11/2024962스크립트: 65. 파이썬 - asgi 버전(2, 3)에 따라 달라지는 uvicorn 호스팅
13641정성태6/11/20241051Linux: 71. Ubuntu 20.04를 22.04로 업데이트
13640정성태6/10/20241039Phone: 21. C# MAUI - Android 환경에서의 파일 다운로드(DownloadManager)
13639정성태6/8/2024969오류 유형: 906. C# MAUI - Android Emulator에서 "Waiting For Debugger"로 무한 대기
13638정성태6/8/20241063오류 유형: 905. C# MAUI - 추가한 layout XML 파일이 Resource.Layout 멤버로 나오지 않는 문제
13637정성태6/6/20241125Phone: 20. C# MAUI - 유튜브 동영상을 MediaElement로 재생하는 방법
13636정성태5/30/20241145닷넷: 2264. C# - 형식 인자로 인터페이스를 갖는 제네릭 타입으로의 형변환파일 다운로드1
13635정성태5/29/2024957Phone: 19. C# MAUI - 안드로이드 "Share" 대상으로 등록하는 방법
13634정성태5/24/20241204Phone: 18. C# MAUI - 안드로이드 플랫폼에서의 Activity 제어
13633정성태5/22/20241151스크립트: 64. 파이썬 - ASGI를 만족하는 최소한의 구현 코드
13632정성태5/20/20241460Phone: 17. C# MAUI - Android 내에 Web 서비스 호스팅
13631정성태5/19/20241483Phone: 16. C# MAUI - /Download 등의 공용 디렉터리에 접근하는 방법
13630정성태5/19/20241857닷넷: 2263. C# - Thread가 Task보다 더 빠르다는 어떤 예제(?)
13629정성태5/18/20241630개발 환경 구성: 710. Android - adb.exe를 이용한 파일 전송
13628정성태5/17/20241627개발 환경 구성: 709. Windows - WHPX(Windows Hypervisor Platform)를 이용한 Android Emulator 가속
13627정성태5/17/20241602오류 유형: 904. 파이썬 - UnicodeEncodeError: 'ascii' codec can't encode character '...' in position ...: ordinal not in range(128)
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...