c# – DirectShow – 如何调试引脚连接故障

前言

在开发使用DirectShow的C#应用程序时，经常会遇到引脚连接故障的问题。这可能是由于不正确的连接或参数设置导致的。调试引脚连接故障可能需要进行深入的分析和排查。本文将介绍一些常见的方法和工具，帮助您调试DirectShow引脚连接故障，并提供相应的代码示例和解释。

方法1：使用GraphEdit工具

GraphEdit是一个非常有用的可视化工具，可以帮助您分析和调试DirectShow图形。您可以使用GraphEdit创建并编辑DirectShow图形，并检查引脚的连接情况。以下是使用GraphEdit调试引脚连接故障的一般步骤：

// 创建FilterGraph对象
FilterGraph filterGraph = new FilterGraph();

// 枚举视频输入设备
DsDevice[] videoDevices = DsDevice.GetDevicesOfCat(FilterCategory.VideoInputDevice);

// 创建VideoCaptureFilter对象
VideoCaptureFilter videoCaptureFilter = new VideoCaptureFilter(videoDevices[0].Mon);

// 将VideoCaptureFilter添加到FilterGraph
filterGraph.AddFilter(videoCaptureFilter, "Video Capture");

// 枚举音频输入设备
DsDevice[] audioDevices = DsDevice.GetDevicesOfCat(FilterCategory.AudioInputDevice);

// 创建AudioCaptureFilter对象
AudioCaptureFilter audioCaptureFilter = new AudioCaptureFilter(audioDevices[0].Mon);

// 将AudioCaptureFilter添加到FilterGraph
filterGraph.AddFilter(audioCaptureFilter, "Audio Capture");

// 创建SampleGrabber对象
SampleGrabber sampleGrabber = new SampleGrabber();

// 将SampleGrabber添加到FilterGraph
filterGraph.AddFilter(sampleGrabber, "Sample Grabber");

// 连接视频捕获设备的输出引脚和SampleGrabber的输入引脚
filterGraph.ConnectDirect(GetPin(videoCaptureFilter, "Capture"), GetPin(sampleGrabber, "Input"));

// 连接音频捕获设备的输出引脚和SampleGrabber的输入引脚
filterGraph.ConnectDirect(GetPin(audioCaptureFilter, "Capture"), GetPin(sampleGrabber, "Input"));

首先，我们创建一个FilterGraph对象，并添加视频捕获设备（VideoCaptureFilter）和音频捕获设备（AudioCaptureFilter）以及SampleGrabber到图形中。然后，使用ConnectDirect方法连接引脚。通过GetPin方法可以获取指定名称的引脚。在创建连接后，我们可以使用GraphEdit检查连接的正确性和问题。

方法2：使用DirectShowLib库进行调试

使用DirectShowLib库可以在代码中进行更详细的调试。以下是一些示例代码，演示如何使用DirectShowLib库来调试引脚连接故障：

// 创建GraphBuilder对象
IGraphBuilder graphBuilder = (IGraphBuilder)new FilterGraph();

// 创建视频捕获设备
ICaptureGraphBuilder2 captureGraphBuilder = (ICaptureGraphBuilder2)new CaptureGraphBuilder2();
captureGraphBuilder.SetFiltergraph(graphBuilder);

ICreateDevEnum devEnum = (ICreateDevEnum)new CreateDevEnum();

// 枚举视频输入设备
IEnumMoniker videoDevices = null;
devEnum.CreateClassEnumerator(FilterCategory.VideoInputDevice, out videoDevices, 0);
if (videoDevices != null)
{
    IMoniker videoDeviceMoniker = null;
    IntPtr videoDevicePointer;
    int videoDeviceIndex = 0;

    // 枚举第一个视频输入设备
    while (videoDevices.Next(1, ref videoDeviceMoniker, IntPtr.Zero) == 0)
    {
        if (videoDeviceIndex == 0)
        {
            videoDeviceMoniker.BindToObject(null, null, typeof(IBaseFilter).GUID, out videoDevicePointer);
            break;
        }
        videoDeviceIndex++;
    }

    if (videoDevicePointer != IntPtr.Zero)
    {
        // 将视频设备添加到GraphBuilder
        IBaseFilter videoCaptureFilter = (IBaseFilter)Marshal.GetObjectForIUnknown(videoDevicePointer);
        graphBuilder.AddFilter(videoCaptureFilter, "Video Capture");

        // 连接视频设备的输出引脚和SampleGrabber的输入引脚
        graphBuilder.ConnectDirect(GetPin(videoCaptureFilter, "Capture"), GetPin(sampleGrabber, "Input"));
    }
}

// 枚举音频输入设备（类似于视频输入设备的枚举过程）

// 构建Graph
captureGraphBuilder.RenderStream(PinCategory.Capture, MediaType.Video, videoDeviceFilter, null, null);
captureGraphBuilder.RenderStream(PinCategory.Capture, MediaType.Audio, audioDeviceFilter, null, null);

上述代码展示了如何使用DirectShowLib库创建FilterGraph并将视频捕获设备和音频捕获设备添加到图形中。接下来，我们使用ConnectDirect方法连接视频设备的输出引脚和SampleGrabber的输入引脚。最后，使用CaptureGraphBuilder的RenderStream方法构建Graph。通过在代码中添加适当的错误处理和日志记录，可以更方便地调试和分析引脚连接故障。

总结

调试DirectShow引脚连接故障涉及使用工具如GraphEdit和DirectShowLib库来检查图形和引脚的连接状态，并进行适当的排查。在编写代码时，我们主要使用FilterGraph、CaptureGraphBuilder和相关接口来构建和操作Graph，通过ConnectDirect方法来连接引脚。通过合理设置参数，并使用错误处理和日志记录，我们可以更好地解决和调试引脚连接故障。