IMFDRMNetHelper interface (wmcontainer.h)
Configures Windows Media Digital Rights Management (DRM) for Network Devices on a network sink.
The Advanced Systems Format (ASF) streaming media sink exposes this interface. To get a pointer to the IMFDRMNetHelper interface, perform the following tasks.
- Get the activation object for the ASF streaming media sink by calling MFCreateASFStreamingMediaSinkActivate.
- Create the media sink by calling the activation object ActivateObject method.
- Get an IMFDRMNetHelper pointer by calling QueryInterface on the media sink.
The IMFDRMNetHelper interface inherits from the IUnknown interface. IMFDRMNetHelper also has these types of members:
The IMFDRMNetHelper interface has these methods.
IMFDRMNetHelper::GetChainedLicenseResponse Not implemented in this release. (IMFDRMNetHelper.GetChainedLicenseResponse) |
IMFDRMNetHelper::ProcessLicenseRequest Gets the license response for the specified request. |
To stream protected content over a network, the ASF streaming media sink provides an output trust authority (OTA) that supports Windows Media DRM for Network Devices and implements the IMFDRMNetHelper interface. For this OTA, encryption occurs on each frame before multiplexing. The license request and response process takes place in the media sink.
The application gets a pointer to IMFDRMNetHelper and uses the methods to handle the license request and response. The application is also responsible for sending the license to the client.
To stream the content, the application does the following:
- Provide the HTTP byte stream to which the media sink writes the streamed content. To stream DRM-protected content over a network from a server to a client, an application must use the Microsoft Media Foundation Protected Media Path (PMP). The media sink and the application-provided HTTP byte stream exist in mfpmp.exe. Therefore, the byte stream must expose the IMFActivate interface so that it can be created out-of-process.Note This might affect how the code is packaged. The DLL that contains the HTTP byte stream and other dependent DLLs must be signed for the Protected Environment (PE-signed).
- Set the MFPKEY_ASFMEDIASINK_DRMACTION property to MFSINK_WMDRMACTION_TRANSCRYPT. The media sink's property store is available to the application through the ASF ContentInfo. To get the property store, call IMFASFContentInfo::GetEncodingConfigurationPropertyStore.
- Get a pointer to the IMFDRMNetHelper interface by querying the media sink.
- To make a license request, call IMFDRMNetHelper::ProcessLicenseRequest. This method calls into the OTA implementation and retrieves the license.When the clock starts for the first time or restarts , the encrypter that is used for encrypting samples is retrieved, and the license response is cached.
- To get the cached license response, call IMFDRMNetHelper::GetChainedLicenseResponse.
Requirement | Value |
---|---|
Minimum supported client | Windows 7 [desktop apps only] |
Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
Target Platform | Windows |
Header | wmcontainer.h |