MediaStreamSource.BeginDrmSetupDecryptor Method (array<Byte[], Guid, Object)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Starts the process of creating a new decryptor.

Namespace: System.Windows.Media
Assembly: System.Windows (in System.Windows.dll)

Syntax

'Declaration
Protected Sub BeginDrmSetupDecryptor ( _
    DrmKeyRotationData As Byte(), _
    KeyId As Guid, _
    userState As Object _
)

protected void BeginDrmSetupDecryptor(
    byte[] DrmKeyRotationData,
    Guid KeyId,
    Object userState
)

DrmKeyRotationData
Type: array<System.Byte[]
A byte array that contains the DRM license data needed to setup the decryptor. DrmKeyRotationData is optional. If it is not required, pass in nulla null reference (Nothing in Visual Basic).

userState
Type: System.Object
The user state that will be passed to the DrmSetupDecryptorCompleted event in the event arguments.

Exception	Condition
ArgumentNullException	KeyId is Empty.
InvalidOperationException	The MediaStreamSource has not reached the MediaOpened state.

BeginDrmSetupDecryptor provides a mechanism to dynamically create decryptors.

BeginDrmSetupDecryptor can be called any time after the MediaOpened state has been reached.

If the initial call to BeginDrmSetupDecryptor does not throw an exception, then there will be exactly one DrmSetupDecryptorCompleted event per call to BeginDrmSetupDecryptor.

A DrmSetupDecryptorCompleted event is raised when the operation is complete. If the AsyncCompletedEventArgs.Error property is nulla null reference (Nothing in Visual Basic), then the setup was successful; otherwise, the setup failed and the AsyncCompletedEventArgs.Error property will contain an Exception object.

Supported in: 5

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.