GetDefaultContentDecryptionModuleFactory function (comppkgsup.h)

Article
02/22/2024

Important

Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns the implementation of IMFContentDecryptionModuleFactory for the specified key system that is built-in to Windows.

Syntax

HRESULT GetDefaultContentDecryptionModuleFactory(
  [in]  PCWSTR                            keySystem,
  [out] IMFContentDecryptionModuleFactory **contentDecryptionModuleFactory
);

Parameters

[in] keySystem

A PCWSTR identifying the key system for which the decryption module is returned.

[out] contentDecryptionModuleFactory

If the specified key system is found, receives pointer to an IMFContentDecryptionModuleFactory implementation; otherwise, NULL.

Return value

An HRESULT including the following values:

Value	Description
S_OK	Success. This function returns success even if the specified key system is not found, but in this case, the contentDecryptionModuleFactory parameter is NULL.
CO_E_NOTINITIALIZED	COM was not initialized before the function was called

Remarks

GetDefaultContentDescryptionModuleFactory only considers content decryption module factories that are built-in to Windows and does not consider content decryption module factories that have been downloaded from the Microsoft Store.

It is recommended that apps use IMFMediaEngineClassFactory4::CreateContentDecryptionModuleFactory, as this method first calls GetDefaultContentDecryptionModuleFactory , but then also searches for any matching implementations of IMFContentDecryptionModuleFactory that may have been downloaded from the Microsoft Store.

Requirements

Requirement	Value
Minimum supported client	Windows 11, version 24H2
Header	comppkgsup.h
Library	Comppkgsup.lib
DLL	Comppkgsup.dll

Share via