通过

步骤 1。 定义设置属性的机制

  • 项目

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

筛选器必须支持属性页与其通信的方式，以便属性页可以在筛选器上设置和检索属性。 可能的机制包括：

  • 公开自定义 COM 接口。
  • 通过 IDispatch 支持自动化属性。
  • 公开 IPropertyBag 接口并定义一组命名属性。

此示例使用名为 ISaturation 的自定义 COM 接口。 这不是实际的 DirectShow 接口;它仅针对此示例定义。 首先，在头文件中声明 接口，以及 IID) (接口标识符：

// Always create new GUIDs! Never copy a GUID from an example.
DEFINE_GUID(IID_ISaturation, 0x19412d6e, 0x6401, 
0x475c, 0xb0, 0x48, 0x7a, 0xd2, 0x96, 0xe1, 0x6a, 0x19);

interface ISaturation : public IUnknown
{
    STDMETHOD(GetSaturation)(long *plSat) = 0;
    STDMETHOD(SetSaturation)(long lSat) = 0;
};

还可以使用 IDL 定义 接口，并使用 MIDL 编译器创建头文件。 接下来，在筛选器中实现自定义接口。 此示例对筛选器的饱和值使用“Get”和“Set”方法。 请注意，这两种方法都使用关键节保护m_lSaturation成员。

class CGrayFilter : public ISaturation, /* Other inherited classes. */
{
private:
    CCritSec  m_csShared;    // Protects shared data.
    long      m_lSaturation; // Saturation level.
public:
    STDMETHODIMP GetSaturation(long *plSat)
    {
        if (!plSat) return E_POINTER;
        CAutoLock lock(&m_csShared);
        *plSat = m_lSaturation;
        return S_OK;
    }
    STDMETHODIMP SetSaturation(long lSat)
    {
        CAutoLock lock(&m_csShared);
        if (lSat < SATURATION_MIN || lSat > SATURATION_MAX)
        {
            return E_INVALIDARG;
        }
        m_lSaturation = lSat;
        return S_OK;
    }
};

当然，你自己的实现的详细信息将不同于此处所示的示例。

下一 步：步骤 2。实现 ISpecifyPropertyPages。

CCritSec 类

创建筛选器属性页