Copyright © 2005-2016 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 class section.

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

 

 

Syntax

 

[Visual Basic]

Public Sub VideoFiltersBlacklistItemAdd (

strCLSID as String

) as enumErrorCodes


 

[C#]

public enumErrorCodes VideoFiltersBlacklistItemAdd (

string strCLSID

);


 

[C++]

public: enumErrorCodes VideoFiltersBlacklistItemAdd (

string 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 get the error code

enumErrorCodes.ERR_NOERROR (0)

The method call was successful