通过

步骤 5。 转换图像

  • 项目

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

这是 编写转换筛选器教程的步骤 5。

上游筛选器通过在转换筛选器的输入引脚上调用 IMemInputPin：：Receive 方法，将媒体样本传送到转换筛选器。 为了处理数据，转换筛选器调用 Transform 方法，该方法是纯虚拟的。 CTransformFilter 和 CTransInPlaceFilter 类使用此方法的两个不同版本：

如果 Transform 方法返回S_OK，筛选器会将示例传送到下游。 若要跳过帧，请返回S_FALSE。 如果出现流式处理错误，则返回失败代码。

以下示例演示 RLE 编码器如何实现此方法。 根据筛选器的用途，你自己的实现可能会有很大的不同。

HRESULT CRleFilter::Transform(IMediaSample *pSource, IMediaSample *pDest)
{
    // Get pointers to the underlying buffers.
    BYTE *pBufferIn, *pBufferOut;
    hr = pSource->GetPointer(&pBufferIn);
    if (FAILED(hr))
    {
        return hr;
    }
    hr = pDest->GetPointer(&pBufferOut);
    if (FAILED(hr))
    {
        return hr;
    }
    // Process the data.
    DWORD cbDest = EncodeFrame(pBufferIn, pBufferOut);
    KASSERT((long)cbDest <= pDest->GetSize());

    pDest->SetActualDataLength(cbDest);
    pDest->SetSyncPoint(TRUE);
    return S_OK;
}

此示例假定 EncodeFrame 是实现 RLE 编码的私有方法。 此处不介绍编码算法本身;有关详细信息，请参阅平台 SDK 文档中的主题“位图压缩”。

首先，该示例调用 IMediaSample：：GetPointer 来检索基础缓冲区的地址。 它将这些传递给专用 EncoderFrame 方法。 然后，它调用 IMediaSample：：SetActualDataLength 来指定编码数据的长度。 下游筛选器需要此信息，以便可以正确管理缓冲区。 最后， 方法调用 IMediaSample：：SetSyncPoint 将关键帧标志设置为 TRUE。 运行长度编码不使用任何增量帧，因此每个帧都是关键帧。 对于增量帧，请将值设置为 FALSE。

必须考虑的其他问题包括：

  • 时间戳。 CTransformFilter 类在调用 Transform 方法之前对输出示例进行时间戳。 它从输入示例中复制时间戳值，而无需修改它们。 如果筛选器需要更改时间戳，请对输出示例调用 IMediaSample：：SetTime 。

  • 格式更改。 上游筛选器可以通过将媒体类型附加到示例来更改中间流格式。 在执行此操作之前，它会在筛选器的输入引脚上调用 IPin：：QueryAccept 。 在 CTransformFilter 类中，这会导致调用 CheckInputType ，后跟 CheckTransform。 下游筛选器还可以使用相同的机制更改媒体类型。 在你自己的筛选器中，需要watch两项内容：

    • 确保 QueryAccept 不返回 false 接受。
    • 如果筛选器接受格式更改，请通过调用 IMediaSample：：GetMediaType 在 Transform 方法中为这些更改检查。 如果该方法返回S_OK，则筛选器必须响应格式更改。

    有关详细信息，请参阅 动态格式更改。

  • 线程数。 在 CTransformFilter 和 CTransInPlaceFilter 中，转换筛选器在 Receive 方法内同步传送输出样本。 筛选器不会创建任何工作线程来处理数据。 通常，转换筛选器没有理由创建工作线程。

下一 步：步骤 6。添加对 COM 的支持。

编写 DirectShow 筛选器