IDvdInfo2::GetCurrentUOPS 方法 (strmif.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 GetCurrentUOPS 检索一组标志,指示内容作者已显式禁用当前光盘位置的导航命令(如果有)。

语法

HRESULT GetCurrentUOPS(
  [out] ULONG *pulUOPs
);

参数

[out] pulUOPs

接收按位 VALID_UOP_FLAG 值。 每个位表示用户操作 (UOP) (有效或无效) 的状态。 如果设置了位,则禁止该用户操作。 请参阅“备注”。

返回值

返回以下 HRESULT 值之一。

返回代码 说明
S_OK
成功。
E_POINTER
pulUOPs 不是有效的指针。

注解

DVD 作者几乎可以在光盘上的任意位置插入 UOP 命令,以禁止在当前 DVD 域中以其他方式允许的导航命令。 换句话说,UOP 命令使光盘作者能够替代通常的导航权限。

DVD 播放器应用程序通常不应使用此方法,因为 DVD 导航器会在继续执行任何命令之前自动检查所有 UOP 权限,如果命令在当前 UOP 下无效,将从任何方法返回VFW_E_DVD_OPERATION_INHIBITED。 如果应用程序需要跟踪当前 UOP 权限本身,则可以在需要当前 UOP 权限时调用 GetCurrentUOPS ,也可以在消息循环中处理 EC_DVD_VALID_UOPS_CHANGE 事件通知,并从 lParam1 参数检索 UOP 信息。 后一种方法通常更有效。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

DVD 应用程序

错误和成功代码

IDvdInfo2 接口