IEVRTrustedVideoPlugin::DisableImageExport method

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

Syntax


HRESULT DisableImageExport(
  [in] BOOL bDisable
);

Parameters

bDisable [in]

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 codeDescription
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]

Header

Evr.h

Library

Mfuuid.lib

See also

Enhanced Video Renderer
Protected Media Path
IEVRTrustedVideoPlugin

 

 

Show: