IOPMVideoOutput::GetInformation method (opmapi.h)

Sends an Output Protection Manager (OPM) status request to the display driver.

Syntax

HRESULT GetInformation(
  [in]  const OPM_GET_INFO_PARAMETERS *pParameters,
  [out] OPM_REQUESTED_INFORMATION     *pRequestedInformation
);

Parameters

[in] pParameters

Pointer to an OPM_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_OPM_SEMANTICS
The OPM object was created with Certified Output Protection Protocol (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 GetInformation method applies only when OPM semantics are used. If the interface pointer was created with COPP semantics, GetInformation returns ERROR_GRAPHICS_OPM_VIDEO_OUTPUT_DOES_NOT_HAVE_OPM_SEMANTICS. In that case, call IOPMVideoOutput::COPPCompatibleGetInformation 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