Integrating WMDRM-ND (Windows CE 5.0)

  • Article

Send Feedback

This section describes how to set up your image to use Windows Media DRM for Network Devices (WMDRM-ND).

To install and setup WMDRM-ND

Installing WMDRM-ND is a manual process. Once you have received your DRM Kit, follow these instructions.

  1. Download the WMDRM-ND Kit for image integration.

    Instructions on how to build WMDRM-ND into your device image are found in the Readme.txt file within the WMDRM-ND Kit provided by Microsoft. The Sysgen variable for WMDRM-ND is SYSGEN_DSHOW_WMT_CardeaDRM.

  2. Retrieve the Unique Device Name (UDN) in the registry

    Your application can use UPnPRendererHost_t to retrieve the UDN and pass it on to DRM. The NMD_UI shows you how to use the protocol UpnpRendererHost_t.

    This is implemented using the following modules that are both linked with nmd.ui.exe:

    Media Query Engine: (Media Query Engine) Initializes the connection between the device and the WMC Server, calls the DRM registration API (to validate itself), responds to the StateVariableChange messages from the Server, and performs the media query request from the application.

    UPnPRendererHost_t: Takes care of the UDN/DD initialization.

    You can use both modules to utilize the full service, however you may choose to use one module or none. If you choose to write your own code, be certain to follow the instructions at the end of this topic.

  3. Obtain a Device Certificate

    To obtain the certificate and private key, follow the steps within the MSDRM-ND Kit provided by Microsoft. Download the WMDRM-ND Kit and refer to the tools and instructions to obtain the private key and certificate.

  4. Secure your Private Key

    Within the MSDRM-ND Kit, there is non-redistributable sample code for DRM_ND_GetPrivateKey**that reads your private key file (*.prv). This key is not protected in any way, and converts the file BLOB into a usable format of the private key.

    Note   Windows CE does not provide sample code on how to protect your private key. You must modify the sample code to protect your private key.

  5. Test Your DRM implementation.

    1. Place this protected content on the WMC Server.

    Note   You must play the content once on the WMC Server before you test it. This will ensure that the license is acquired on the PC side.

    1. Play the protected file on the NMD.

      Your DRM implementation is successful when you can play back any protected file.

  6. Confirm that your device is Authorized

    Confirm that this device is authorized and capable of DRM, prior to calling DRM_API: DRM_ND_RegisterWithService.

    Programmatically

    Call IsAuthorize. For more information, see the whitepaper How to Build a Network Device Compatible with WMC, section 5.1.3, Discovering Authorization Status. This whitepaper can be downloaded from Windows Media Connect: For Industry

    Manually

    On the Task Bar, click Start, click Windows Media Connect.

    Click the Devices tab of the Windows Media Connect dialog box.

    Select your device from the list of available devices, and click Properties.

    Set the DRM item in Properties and click OK.

    In the list of devices, youll now see a green Allowed next to your device name.

  7. Validate the Device

    Your application must validate the device before you can play protected content. The device calls DRM_ND_RegisterWithService to validate itself. See the following example from the source of the Media Query Engine.

    DRM_API DRM_ND_Init(void);
DRM_API DRM_ND_RegisterWithService(BSTR IN sOurUDN,BSTR IN sServiceUDN,IUPnPService *pService);
DRM_API DRM_ND_DeregisterFromService(BSTR IN sServiceUDN);

See Also

Windows Media DRM for Network Devices

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.