Edit

Share via

Internal Script Command Renderer Filter

  • Article

[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.]

Receives script commands and dispatches them to the application.

This filter accepts script commands in one of two formats:

  • MEDIATYPE_Text: Each media sample contains an ANSI text string.

  • MEDIATYPE_ScriptCommand: Each media sample contains two NULL-terminated Unicode strings, concatenated together. The first string describes the command type and the second string is the script command.

    When the filter receives a sample, it sends an EC_OLE_EVENT event notification. The first event parameter is a BSTR with the command type, or Text if the format is MEDIATYPE_Text. The second event parameter is a BSTR with the script command. The application can retrieve the event and respond to the script command.

For an example of how to use this filter, see SAMI (CC) Parser.

Label Value
Filter Interfaces IBaseFilter, IMediaPosition, IMediaSeeking
Input Pin Media Types
  • MEDIATYPE_ScriptCommand, MEDIASUBTYPE_NULL
  • MEDIATYPE_Text, MEDIASUBTYPE_NULL
Input Pin Interfaces IMemInputPin, IPin, IQualityControl
Output Pin Media Types Not applicable
Output Pin Interfaces Not applicable
Filter CLSID {48025243-2D39-11CE-875D-00608CB78066}
Property Page CLSID No property page
Executable Quartz.dll
Merit MERIT_PREFERRED + 1
Filter Category CLSID_LegacyAmFilterCategory

 

DirectShow Filters