Creating a Filter Property Page

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

This section describes how to create a property page for a custom DirectShow filter, using the CBasePropertyPage class. The example code in this section shows all the steps needed to create a property page. The example shows a property page for a hypothetical video effect filter that supports a saturation property. The property page has a slider, which the user can move to adjust the filter's saturation level.

This section contains the following topics:

• Step 1. Define a Mechanism for Setting the Property
• Step 2. Implement ISpecifyPropertyPages
• Step 3. Support QueryInterface
• Step 4. Create the Property Page
• Step 5. Store a Pointer to the Filter
• Step 6. Initialize the Dialog
• Step 7. Handle Window Messages
• Step 8. Apply Property Changes
• Step 9. Disconnect the Property Page
• Step 10. Support COM Registration

Related topics

Writing DirectShow Filters