Edit

IMFOutputPolicy::GenerateRequiredSchemas method (mfidl.h)

  • Article

Retrieves a list of the output protection systems that the output trust authority (OTA) must enforce, along with configuration data for each protection system.

Syntax

HRESULT GenerateRequiredSchemas(
  [in]  DWORD         dwAttributes,
  [in]  GUID          guidOutputSubType,
  [in]  GUID          *rgGuidProtectionSchemasSupported,
  [in]  DWORD         cProtectionSchemasSupported,
  [out] IMFCollection **ppRequiredProtectionSchemas
);

Parameters

[in] dwAttributes

Describes the output that is represented by the OTA calling this method. This value is a bitwise OR of zero or more of the following flags.

Value Meaning
MFOUTPUTATTRIBUTE_BUS
 Hardware bus.
MFOUTPUTATTRIBUTE_COMPRESSED
 The output sends compressed data. If this flag is absent, the output sends uncompressed data.
MFOUTPUTATTRIBUTE_BUSIMPLEMENTATION
 Reserved. Do not use.
MFOUTPUTATTRIBUTE_DIGITAL
 The output sends a digital signal. If this flag is absent, the output sends an analog signal.
MFOUTPUTATTRIBUTE_NONSTANDARDIMPLEMENTATION
 Reserved. Do not use.
MFOUTPUTATTRIBUTE_SOFTWARE
 Reserved. Do not use.
MFOUTPUTATTRIBUTE_VIDEO
 The output sends video data. If this flag is absent, the output sends audio data.

[in] guidOutputSubType

Indicates a specific family of output connectors that is represented by the OTA calling this method. Possible values include the following.

Value Meaning
MFCONNECTOR_AGP
 AGP bus.
MFCONNECTOR_COMPONENT
 Component video.
MFCONNECTOR_COMPOSITE
 Composite video.
MFCONNECTOR_D_JPN
 Japanese D connector. (Connector conforming to the EIAJ RC-5237 standard.)
MFCONNECTOR_DISPLAYPORT_EMBEDDED
 Embedded DisplayPort connector.
MFCONNECTOR_DISPLAYPORT_EXTERNAL
 External DisplayPort connector.
MFCONNECTOR_DVI
 Digital video interface (DVI) connector.
MFCONNECTOR_HDMI
 High-definition multimedia interface (HDMI) connector.
MFCONNECTOR_LVDS
 Low voltage differential signaling (LVDS) connector.

A connector using the LVDS interface to connect internally to a display device. The connection between the graphics adapter and the display device is permanent and not accessible to the user. Applications should not enable High-Bandwidth Digital Content Protection (HDCP) for this connector.
MFCONNECTOR_PCI
 PCI bus.
MFCONNECTOR_PCI_Express
 PCI Express bus.
MFCONNECTOR_PCIX
 PCI-X bus.
MFCONNECTOR_SDI
 Audio data sent over a connector via S/PDIF.
MFCONNECTOR_SPDIF
 Serial digital interface connector.
MFCONNECTOR_SVIDEO
 S-Video connector.
MFCONNECTOR_UDI_EMBEDDED
 Embedded Unified Display Interface (UDI).
MFCONNECTOR_UDI_EXTERNAL
 External UDI.
MFCONNECTOR_UNKNOWN
 Unknown connector type. See Remarks.
MFCONNECTOR_VGA
 VGA connector.
MFCONNECTOR_MIRACAST
 Miracast wireless connector.

Supported in Windows 8.1 and later.

[in] rgGuidProtectionSchemasSupported

Pointer to an array of GUID values that specify which output protection systems are supported by the OTA that is calling this method.

[in] cProtectionSchemasSupported

Number of elements in the rgGuidProtectionSchemasSupported array.

[out] ppRequiredProtectionSchemas

Receives a pointer to the IMFCollection interface of a collection object. The caller must release the interface. Each object in the collection is an IMFOutputSchema pointer. Each IMFOutputSchema pointer defines an output protection system that the OTA must enforce.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The video OTA returns the MFCONNECTOR_UNKNOWN connector type unless the Direct3D device is in full-screen mode. (Direct3D windowed mode is not generally a secure video mode.) You can override this behavior by implementing a custom EVR presenter that implements the IEVRTrustedVideoPlugin interface.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

IMFOutputPolicy