IDvdInfo2::GetCurrentUOPS 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 GetCurrentUOPS
检索一组标志,指示内容作者已显式禁用当前光盘位置的导航命令(如果有)。
语法
HRESULT GetCurrentUOPS(
[out] ULONG *pulUOPs
);
参数
[out] pulUOPs
接收按位 VALID_UOP_FLAG 值。 每个位表示用户操作 (UOP) (有效或无效) 的状态。 如果设置了位,则禁止该用户操作。 请参阅“备注”。
返回值
返回以下 HRESULT 值之一。
返回代码 | 说明 |
---|---|
|
成功。 |
|
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 |