共用方式為

IUnifo2：：GetFPGATextStringAsUnicode 方法 (strmif.h)

  • 發行項

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

方法 GetDVDTextStringAsUnicode 會擷取指定語言的 DVD 文字字串，並將文字字串傳回為 Unicode 字串。

語法

HRESULT GetDVDTextStringAsUnicode(
  [in]  ULONG              ulLangIndex,
  [in]  ULONG              ulStringIndex,
  [out] WCHAR              *pchwBuffer,
  [in]  ULONG              ulMaxBufferSize,
  [out] ULONG              *pulActualSize,
  [out] DVD_TextStringType *pType
);

參數

[in] ulLangIndex

以零起始的語言索引。 若要在 DVD 上尋找文字字串語言的數目，請呼叫 IInInfo2：：GetTextNumberOfLanguages。

[in] ulStringIndex

要擷取之字串之以零起始的索引。 若要尋找指定語言的字串數目，請呼叫 IIdInfo2：：GetTextLanguageInfo。

[out] pchwBuffer

接收文字字串之緩衝區的指標。 如果 pchBuffer 為 NULL，這個方法會傳回 pulActualSize 中的字串大小。

[in] ulMaxBufferSize

WCHAR 中 pchBuffer 緩衝區的大小。

[out] pulActualSize

以字元接收字串的實際長度，包括終止 的NULL。

[out] pType

接收 DVD_TextStringType 列舉的成員。 值表示文字字串的類型，例如電影標題或歌曲名稱。 此參數也可以接收 DVD_TextStringType列舉中 未定義的值。

傳回值

傳回下列其中一個 HRESULT 值。

傳回碼 描述
S_OK
 成功。
E_FAIL
 不支援的te
E_POINTER
 無效引數。
E_UNEXPECTED
 發生非預期的內部錯誤。

備註

此方法支援以 Unicode 或 7 位 ASCII 編碼的文字字串， (ISO/IEC 646) 。 如果文字字串使用 ASCII 編碼，此方法會將字串轉換成寬字元字串。 如果文字字串使用任何其他字元集，此方法會傳回E_FAIL。 在此情況下，您可以呼叫 IWindowsInfo2：：GetTextStringAsNative ，以原始位元組數位的形式擷取字元串。 若要尋找字元集，請呼叫 IHttpInfo2：：GetTextLanguageInfo。

傳回的字串一律包含終止 的NULL。 如果緩衝區小於 DVD 文字字串的長度，則會截斷字串。 若要尋找所需的緩衝區大小，請呼叫 pchBuffer 等於 NULL 且 ulMaxBufferSize 等於零的方法一次。 大小會以 pulActualSize 傳回。 然後配置緩衝區，然後再次呼叫 方法。

規格需求

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

另請參閱

DVD 應用程式

錯誤和成功碼

IInfo2 介面

使用 DVD 文字字串