IToiDrmService Interface Reference


Description

Technical Preview:
This interface is a TECHNICAL PREVIEW, it may change. The IToiDrmService provides application access to the DRM service.
See also:
IToiDrmObserver

import "IToiDrmService.idl";

List of all members.

Public Member Functions

void GetCurrentOutputControl (in long mediaSessionId, out TToiOutputControl outputControl) raises (TToiInvalidArgumentException)
void QueryCopyPermission (in string assetUrl, out TToiCopyPermission copyPermission, out long remainingCopies) raises (TToiInvalidArgumentException)
void RegisterObserver (in IToiApplicationService::TToiApplicationId applicationId, in string address) raises (TToiInvalidArgumentException)
void ReleaseObserver (in string address) raises (TToiInvalidArgumentException)

Classes

struct  TToiOutputControl

Public Types

enum  TToiCopyPermission { COPY_FREE, COPY_NO_MORE, COPY_10, COPY_NEVER }

Member Enumeration Documentation

Copy permissions for assets

Enumerator:
COPY_FREE 

The asset can be copy freely

COPY_NO_MORE 

The asset can not be copied anymore

COPY_10 

The asset can be copied at most 10 times

COPY_NEVER 

The asset cannot be copied


Member Function Documentation

void IToiDrmService::GetCurrentOutputControl ( in long  mediaSessionId,
out TToiOutputControl  outputControl 
) raises (TToiInvalidArgumentException)

Returns the current output control for a specific session.

Parameters:
mediaSessionId The media session for which the CCI is requested.
Return values:
outputControl The CCI.
Exceptions:
TToiInvalidArgumentException The media session identifier is invalid.
void IToiDrmService::QueryCopyPermission ( in string  assetUrl,
out TToiCopyPermission  copyPermission,
out long  remainingCopies 
) raises (TToiInvalidArgumentException)

Queries whether an asset can be copied.

Parameters:
assetUrl The URL to the asset
Return values:
copyPermission Indicates the permission.
remainingCopies If copyPermission is COPY_10, this argument indicates the number of remaining copies.
Exceptions:
TToiInvalidArgumentException The asset identifier is invalid.
void IToiDrmService::RegisterObserver ( in IToiApplicationService::TToiApplicationId  applicationId,
in string  address 
) raises (TToiInvalidArgumentException)

Register an observer of type IToiDrmObserver. The observer will receive events sent by this IToiDrmService instance.

Parameters:
applicationId The identifier of the observing application.
address The address where the IToiDrmService can find an IToiDrmObserver interface.
Exceptions:
TToiInvalidArgumentException Raised if the specified address is invalid or if the application has already registered itself as an observer with the same address.
See also:
IToiDrmObserver
void IToiDrmService::ReleaseObserver ( in string  address  )  raises (TToiInvalidArgumentException)

Release an observer previously registered with RegisterObserver.

Parameters:
address The address where the IToiDrmService can find the registered IToiDrmObserver interface.
Exceptions:
TToiInvalidArgumentException Raised if the specified address is invalid.
See also:
IToiDrmObserver