Share via

IHsInfo：：GetRoot 方法 (strmif.h)

  • 發行項

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

注意IInfo 介面已被取代。 請改用 IInfo2 。
 
擷取播放器中設定的根目錄。

語法

HRESULT GetRoot(
  [out] LPSTR pRoot,
  [in]  ULONG ulBufSize,
  [out] ULONG *pulActualSize
);

參數

[out] pRoot

要接收根字串之緩衝區的指標。 請注意，根字串使用 ANSI 字元。

[in] ulBufSize

傳入的緩衝區大小，以位元組為單位。

[out] pulActualSize

值指標，其中包含傳回的實際數據大小。

傳回值

傳回 HRESULT 值。

傳回碼 Description
E_UNEXPECTED
 DVD 未初始化，或網域未DVD_DOMAIN_Title。
S_OK
 成功。
VFW_E_DVD_INVALIDDOMAIN
 此網域不支援要求的動作 (DVD_DOMAIN) 。
VFW_E_DVD_OPERATION_INHIBITED
 由於目前 DVD-Video 光碟的撰寫，所以影片目前無法執行要求的動作。

備註

如果找到有效的根目錄，這個方法會傳回根字串。 否則，它會傳回 零表示找不到或初始化有效的根目錄。

規格需求

需求 值
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)

另請參閱

錯誤和成功碼

I{Info 介面>