(strmif.h) 的 IHttpInfo2::GetCurrentUOPS 方法

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayerIMFMediaEngine音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼,以使用新的 API。]

方法 GetCurrentUOPS 會擷取一組旗標,指出如果有的話,內容作者已明確停用目前光碟位置的瀏覽命令。

語法

HRESULT GetCurrentUOPS(
  [out] ULONG *pulUOPs
);

參數

[out] pulUOPs

接收位 VALID_UOP_FLAG 值。 每個位都代表用戶作業 (UOP) 之狀態 (有效或) 無效。 如果設定位,則禁止該用戶作業。 請參閱<備註>。

傳回值

傳回下列其中一個 HRESULT 值。

傳回碼 描述
S_OK
成功。
E_POINTER
pulUOP 不是有效的指標。

備註

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)
程式庫 Strmiids.lib

另請參閱

DVD 應用程式

錯誤和成功碼

IMyInfo2 介面