Copyright © 2001-2019 MultiMedia Soft

VideoFiltersBlacklistItemAdd method

Previous pageReturn to chapter overviewNext page

Remarks

 

Adds a DirectShow filter or codec to the blacklist of filters whose usage should be rejected during the filter graph building. Blacklisted filters can be removed at any time from the black list through the VideoFiltersBlacklistItemRemove method; the black list can be reset through the VideoFiltersBlacklistReset method or disabled through the VideoFiltersBlacklistDisable method.

 

Inside Appendix B you will find a few guidelines that could be of help in order to manage DirectShow configuration through K-Lite provided tools.

 

For further details about the use of the embedded video player see the VideoPlayer object section.

For details about video clips rendering refer to the How to play video files through DirectShow tutorial.

 

 

Syntax

 

[Visual Basic]

control.VideoFiltersBlacklistItemAdd (

strCLSID as String

) as enumErrorCodes


 

[C++]

short control.VideoFiltersBlacklistItemAdd (

BSTR strCLSID

);


 

 

Parameter

Description

 

 

strCLSID

String containing the class identifier (CLSID) of the filter to blacklist; a CLSID is a 128 bit (large) number that represents a unique identifier for a software application or application component. This parameter must be in the format "{AE7AB96B-FF5E-4dce-801E-14DF2C4CD681}". The presence of curly brackets  inside the string is mandatory.

There are several applications which can be used to obtain the CLSID string for a specific filter: InstalledCodecs by NirSoft, GraphEditPlus by Infognition, GraphStudioNext and others.

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred, check the LastError property value in order to see the error code meaning

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.