Export (0) Print
Expand All

IMFInputTrustAuthority::RequestAccess method

Requests permission to perform a specified action on the stream.

Syntax


HRESULT RequestAccess(
  [in]   MFPOLICYMANAGER_ACTION Action,
  [out]  IMFActivate **ppContentEnablerActivate
);

Parameters

Action [in]

The requested action, specified as a member of the MFPOLICYMANAGER_ACTION enumeration.

ppContentEnablerActivate [out]

Receives the value NULL or a pointer to the IMFActivate interface. The IMFActivate interface is used to create a content enabler object. The caller must release the interface. For more information, see Remarks.

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 user has permission to perform this action.

NS_E_DRM_NEEDS_INDIVIDUALIZATION

The user must individualize the application.

NS_E_LICENSE_REQUIRED

The user must obtain a license.

 

Remarks

This method verifies whether the user has permission to perform a specified action on the stream. The ITA does any work needed to verify the user's right to perform the action, such as checking licenses.

To verify the user's rights, the ITA might need to perform additional steps that require interaction with the user or consent from the user. For example, it might need to acquire a new license or individualize a DRM component. In that case, the ITA creates an activation object for a content enabler and returns the activation object's IMFActivate interface in the ppContentEnablerActivate parameter. The activation object is responsible for creating a content enabler that exposes the IMFContentEnabler interface. The content enabler is used as follows:

  1. The Media Session returns the IMFActivate pointer to the application.

  2. The application calls IMFActivate::ActivateObject to activate the content enabler.

  3. The application calls IMFContentEnabler methods to perform whatever actions are needed, such as individualization or obtaining a license. The content enabler object must encapsulate this functionality through the IMFContentEnabler interface.

  4. The Media Session calls RequestAccess again.

The return value signals whether the user has permission to perform the action:

  • If the user already has permission to perform the action, the method returns S_OK and sets *ppContentEnablerActivate to NULL.

  • If the user does not have permission, the method returns a failure code and sets *ppContentEnablerActivate to NULL.

  • If the ITA must perform additional steps that require interaction with the user, the method returns a failure code and returns the content enabler's IMFActivate pointer in ppContentEnablerActivate.

The Media Session will not allow the action unless this method returns S_OK. However, a return value of S_OK does not guarantee that the action will be performed, because some other failure might occur after this method is called. When the action is definitely about to happen, the Media Session calls IMFInputTrustAuthority::BindAccess.

A stream can go to multiple outputs, so this method might be called multiple times with different actions, once for every output.

Requirements

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

Mfidl.h

Library

Mfuuid.lib

See also

IMFInputTrustAuthority

 

 

Community Additions

ADD
Show:
© 2014 Microsoft