Share via

iHttpInfo2：：GetCurrentSubpicture 方法 (strmif.h)

  • 發行項

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

方法 GetCurrentSubpicture 會擷取目前標題中可用的子圖形數據流數目、目前選取的子圖片數據流編號，以及子圖片的狀態。

語法

HRESULT GetCurrentSubpicture(
  [out] ULONG *pulStreamsAvailable,
  [out] ULONG *pulCurrentStream,
  [out] BOOL  *pbIsDisabled
);

參數

[out] pulStreamsAvailable

接收可用的子圖形數據流數目。

[out] pulCurrentStream

接收目前選取的子圖形數據流數目。

[out] pbIsDisabled

接收布爾值，指出是否停用子圖片顯示; TRUE 表示已停用。

傳回值

傳回下列其中一個 HRESULT 值。

傳回碼 描述
S_OK
 成功。
E_POINTER
 無效引數。
VFW_E_DVD_INVALIDDOMAIN
 DVD 導覽器未在標題網域中初始化或未初始化。

備註

DVD 內容作者可以指定強制啟動光碟上的任何特定子圖片數據流，這表示 DVD 作者需要此數據流來顯示查看器是否想要 watch 它。 DVD Navigator 符合光碟的所有這類命令，這表示即使應用程式已停用子圖片顯示，仍會顯示強制啟動的數據流，並搭配 IHttpControl2：：SetSubpictureState 方法顯示。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

DVD 應用程式

EC_DVD_SUBPICTURE_STREAM_CHANGE

錯誤和成功碼

IMyInfo2 介面