Edit

Share via

IOPMVideoOutput::COPPCompatibleGetInformation method (opmapi.h)

  • Article

Sends an Output Protection Manager (OPM) status request to the display driver. Use this method when OPM is emulating Certified Output Protection Manager (COPP).

Syntax

HRESULT COPPCompatibleGetInformation(
  [in]  const OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS *pParameters,
  [out] OPM_REQUESTED_INFORMATION                     *pRequestedInformation
);

Parameters

[in] pParameters

Pointer to an OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS structure. Fill in this structure with data for the status request. For a list of status requests, see OPM Status Requests.

[out] pRequestedInformation

Pointer to an OPM_REQUESTED_INFORMATION structure. On return, the method fills in this structure with the results of the status request.

Return value

Returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
 The method succeeded.
ERROR_GRAPHICS_OPM_VIDEO_OUTPUT_DOES_NOT_HAVE_COPP_SEMANTICS
 The OPM object was created with OPM semantics, not COPP semantics.

Remarks

This method is equivalent to the IAMCertifiedOutputProtection::ProtectionStatus method in COPP.

The IOPMVideoOutput interface supports both OPM semantics and COPP semantics. The COPPCompatibleGetInformation method applies only when COPP semantics are used. If the interface pointer was created with OPM semantics, COPPCompatibleGetInformation returns ERROR_GRAPHICS_OPM_VIDEO_OUTPUT_DOES_NOT_HAVE_COPP_SEMANTICS. In that case, call IOPMVideoOutput::GetInformation instead.

Requirements

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

See also

IOPMVideoOutput

Output Protection Manager