IDvdInfo2::GetDVDTextStringAsUnicode メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオキャプチャに置き換わりました。これらの機能は、Windows 10とWindows 11用に最適化されています。新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 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

言語の 0 から始まるインデックス。 DVD のテキスト文字列言語の数を見つけるには、 IDvdInfo2::GetDVDTextNumberOfLanguages を呼び出します。

[in] ulStringIndex

取得する文字列の 0 から始まるインデックス。特定の言語の文字列の数を検索するには、 IDvdInfo2::GetDVDTextLanguageInfo を呼び出します。

[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を返します。その場合は、 IDvdInfo2::GetDVDTextStringAsNative を呼び出して、文字列を生のバイト配列として取得できます。文字セットを検索するには、 IDvdInfo2::GetDVDTextLanguageInfo を呼び出します。

返される文字列には、常に終端の NULL が含まれます。バッファーが DVD テキスト文字列の長さより小さい場合、文字列は切り捨てられます。バッファーの必要なサイズを見つけるには、 pchBuffer が NULL 、 ulMaxBufferSize が 0 のメソッドを 1 回呼び出します。サイズは pulActualSize で返されます。次に、バッファーを割り当てて、メソッドをもう一度呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	strmif.h (Dshow.h を含む)
Library	Strmiids.lib