IWMDRMTranscryptor interface (wmsdkidl.h)
[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
[IWMDRMTranscryptor is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use Microsoft PlayReady. ]
The IWMDRMTranscryptor interface transforms a DRM-protected ASF file into a secure data stream conforming to the Windows Media DRM 10 for Network Devices protocol. The resulting stream can be sent to devices that support Windows Media DRM 10 for Network Devices.
IWMDRMTranscryptor is the primary interface of the DRM transcryptor object. You can obtain a pointer to an instance of this interface by calling the WMCreateDRMTranscryptor function.
Inheritance
The IWMDRMTranscryptor interface inherits from the IUnknown interface. IWMDRMTranscryptor also has these types of members:
Methods
The IWMDRMTranscryptor interface has these methods.
| IWMDRMTranscryptor::Close The Close method unloads the file from the DRM transcryptor and releases all associated resources. |
| IWMDRMTranscryptor::Initialize The Initialize method loads a file into the DRM transcryptor. A file must be loaded before the transcryptor can process any data. |
| IWMDRMTranscryptor::Read The Read method reads data from the file loaded in the transcryptor and encrypts it for streaming to devices that support Windows Media DRM 10 for Network Devices. |
| IWMDRMTranscryptor::Seek The Seek method sets the DRM transcryptor to read from the specified point in the data stream of the loaded file. Subsequent Read calls generate data beginning at that point. |
Remarks
The DRM transcryptor is initialized after a policy request message is sent by a device. You can parse a license request and obtain the device certificate, the device serial number, and the requested action by calling IWMDRMMessageParser::ParseLicenseRequestMsg.
The methods of the IWMDRMTranscryptor interface use the IWMStatusCallback::OnStatus callback method to inform the application of progress. For more information, see Using the Callback Methods.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | wmsdkidl.h |