OPM_SET_HDCP_SRM

Updates the system renewability message (SRM) for High-Bandwidth Digital Content Protection (HDCP).

Requirement Value
Command GUID OPM_SET_HDCP_SRM
Input data An OPM_SET_HDCP_SRM_PARAMETERS structure

 

The pbAdditionalParameters parameter of IOPMVideoOutput::Configure must point to a buffer that contains the SRM. The format of an HDCP SRM is documented in the HDCP specification. Set the ulAdditionalParametersSize parameter equal to the size of the buffer, in bytes.

Remarks

SRMs are used to update the list of revoked HDCP devices. SRMs are delivered with the video content.

This command updates the video output's current SRM. If HDCP is enabled at the time of the command, the video output uses the new SRM to check whether any of the connected HDCP devices are revoked. If the video output detects a revoked device, it stops displaying video. If you send this command while HDCP is disabled, the video output validates the SRM and stores it. Later, if the application enables HDCP, the video output uses the new SRM to check the device's revocation status.

This command can cause the Configure method to return any of the following error codes.

Return code Description
ERROR_GRAPHICS_OPM_INVALID_SRM The SRM is not valid.
ERROR_GRAPHICS_OPM_OUTPUT_DOES_NOT_SUPPORT_HDCP The video output does not support HDCP.

 

This command is not supported when the IOPMVideoOutput interface emulates Certified Output Protection Protocol (COPP). When COPP semantics are used, the application is responsible for parsing SRMs and checking the revocation status of the HDCP device. Use the OPM_GET_CONNECTED_HDCP_DEVICE_INFORMATION status request to get the device's key selection vector (KSV), which is needed to check the revocation status. For more information about SRMs, refer to the HDCP specification.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Opmapi.h

See also

IOPMVideoOutput::Configure

OPM Commands