Edit

Share via

OPMGetVideoOutputForTarget function (opmapi.h)

  • Article

Returns a video output object for the VidPN target on the specified adapter.

Syntax

HRESULT OPMGetVideoOutputForTarget(
  [in]  LUID                       *pAdapterLuid,
  [in]  ULONG                      VidPnTarget,
  [in]  OPM_VIDEO_OUTPUT_SEMANTICS vos,
  [out] IOPMVideoOutput            **ppOPMVideoOutput
);

Parameters

[in] pAdapterLuid

The LUID for the adapter where the target is located.

[in] VidPnTarget

Target ID for the target on the specified adapter.

[in] vos

A member of the OPM_VIDEO_OUTPUT_SEMANTICS enumeration.

Value Meaning
OPM_VOS_OPM_SEMANTICS
 The returned IOPMVideoOutput pointer will use OPM semantics.
OPM_VOS_COPP_SEMANTICS
 The returned IOPMVideoOutput pointer will use Certified Output Protection Protocol (COPP) semantics.

[out] ppOPMVideoOutput

Receives a pointer to an IOPMVideoOutput pointer. The caller must release this pointer.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The IOPMVideoOutput interface has two modes of behavior, depending on the value of the vos parameter. If vos is OPM_VOS_COPP_SEMANTICS, IOPMVideoOutput uses COPP semantics. This mode is intended for backward compatibility with COPP. If vos is OPM_VOS_OPM_SEMANTICS, IOPMVideoOutput uses the newer OPM semantics. Differences in behavior are noted on the reference page for each method. The mode does not change during the lifetime of the object.

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
Library Dxva2.lib
DLL Dxva2.dll

See also

OPM Functions