Compartir a través de

Paso 2. Implementar ISpecifyPropertyPages

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

A continuación, implemente la interfaz ISpecifyPropertyPages en el filtro. Esta interfaz tiene un único método, GetPages, que devuelve una matriz de CLSID para las páginas de propiedades que admite el filtro. En este ejemplo, el filtro tiene una sola página de propiedades. Empiece por generar el CLSID y declararlo en el archivo de encabezado:

// Always create new GUIDs! Never copy a GUID from an example.
DEFINE_GUID(CLSID_SaturationProp, 0xa9bd4eb, 0xded5, 
0x4df0, 0xba, 0xf6, 0x2c, 0xea, 0x23, 0xf5, 0x72, 0x61);

Ahora implemente el método GetPages :

class CGrayFilter : public ISaturation,
                    public ISpecifyPropertyPages, 
                    /* Other inherited classes. */
{
public:
    STDMETHODIMP GetPages(CAUUID *pPages)
    {
        if (pPages == NULL) return E_POINTER;
        pPages->cElems = 1;
        pPages->pElems = (GUID*)CoTaskMemAlloc(sizeof(GUID));
        if (pPages->pElems == NULL) 
        {
            return E_OUTOFMEMORY;
        }
        pPages->pElems[0] = CLSID_SaturationProp;
        return S_OK;
    }
};

/* ... */

}

Asigne memoria para la matriz mediante CoTaskMemAlloc. El autor de la llamada liberará la memoria.

Siguiente: Paso 3. Compatibilidad con QueryInterface.

Crear una página de propiedades de filtro