Compartilhar via

Etapa 1. Definir um mecanismo para definir a propriedade

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O filtro deve dar suporte a uma maneira de a página de propriedades se comunicar com ela, para que a página de propriedades possa definir e recuperar propriedades no filtro. Os mecanismos possíveis incluem o seguinte:

  • Expor uma interface COM personalizada.
  • Suporte a propriedades de Automação, por meio de IDispatch.
  • Exponha a interface IPropertyBag e defina um conjunto de propriedades nomeadas.

Este exemplo usa uma interface COM personalizada, chamada ISaturation. Esta não é uma interface DirectShow real; ele é definido apenas para este exemplo. Comece declarando a interface em um arquivo de cabeçalho, juntamente com o IID (identificador de interface):

// 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;
};

Você também pode definir a interface com IDL e usar o compilador MIDL para criar o arquivo de cabeçalho. Em seguida, implemente a interface personalizada no filtro. Este exemplo usa métodos "Get" e "Set" para o valor de saturação do filtro. Observe que ambos os métodos protegem o membro m_lSaturation com uma seção crítica.

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;
    }
};

É claro que os detalhes de sua própria implementação serão diferentes do exemplo mostrado aqui.

Próximo: Etapa 2. Implemente ISpecifyPropertyPages.

Classe CCritSec

Criando uma página de propriedades de filtro