IEVRTrustedVideoPlugin::DisableImageExport method (evr.h)

Enables or disables the ability of the plug-in to export the video image.

Syntax

HRESULT DisableImageExport(
  BOOL bDisable
);

Parameters

bDisable

Boolean value. Specify TRUE to disable image exporting, or FALSE to enable it.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.

Remarks

An EVR plug-in might expose a way for the application to get a copy of the video frames. For example, the standard EVR presenter implements IMFVideoDisplayControl::GetCurrentImage.

If the plug-in supports image exporting, this method enables or disables it. Before this method has been called for the first time, the EVR assumes that the mechanism is enabled.

If the plug-in does not support image exporting, this method should return S_OK and ignore the value of bDisable. If the method fails, the EVR treats it as a failure to enforce the policy, which will probably cause playback to stop.

While image exporting is disabled, any associated export method, such as GetCurrentImage, should return MF_E_LICENSE_INCORRECT_RIGHTS.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header evr.h
Library Mfuuid.lib

See also

Enhanced Video Renderer

IEVRTrustedVideoPlugin

Protected Media Path