次の方法で共有

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

こちらもご覧ください

DVD アプリケーション

エラーコードと成功コード

IDvdInfo2 インターフェイス

DVD テキスト文字列の操作