IOPMVideoOutput::Configure 方法 (opmapi.h)

配置视频输出。 此方法将输出保护管理器 (OPM) 或认证输出保护协议 (COPP) 命令发送到驱动程序。

语法

HRESULT Configure(
  [in] const OPM_CONFIGURE_PARAMETERS *pParameters,
  [in] ULONG                          ulAdditionalParametersSize,
  [in] const BYTE                     *pbAdditionalParameters
);

参数

[in] pParameters

指向包含 命令的OPM_CONFIGURE_PARAMETERS 结构的指针。 有关 OPM 命令的列表,请参阅 OPM 命令

[in] ulAdditionalParametersSize

pbAdditionalParameters 缓冲区的大小(以字节为单位)。

[in] pbAdditionalParameters

指向包含命令的其他信息的缓冲区的指针。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法等效于 COPP 中的 IAMCertifiedOutputProtection::P rotectionCommand 方法。

此方法支持 OPM 语义和 COPP 语义。 支持 COPP 语义以实现向后兼容性;新应用程序应使用 OPM 语义。

OPM 语义

某些 OPM 命令需要在 pbAdditionalParameters 参数中传递其他配置信息。 ulAdditionalParametersSize 参数指定附加数据的大小。

COPP 语义

pbAdditionalParameters 参数必须为 NULL,ulAdditionalParametersSize 必须为零。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 opmapi.h

另请参阅

IOPMVideoOutput

输出保护管理器