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