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

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

メソッドは GetDVDTextStringAsNative 、指定した言語の DVD テキスト文字列を取得し、テキスト文字列をバイト配列として返します。

構文

HRESULT GetDVDTextStringAsNative(
  [in]  ULONG              ulLangIndex,
  [in]  ULONG              ulStringIndex,
  [out] BYTE               *pbBuffer,
  [in]  ULONG              ulMaxBufferSize,
  [out] ULONG              *pulActualSize,
  [out] DVD_TextStringType *pType
);

パラメーター

[in] ulLangIndex

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

[in] ulStringIndex

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

[out] pbBuffer

テキスト文字列を受け取るバッファーへのポインター。 pchBuffer が NULL の場合、このメソッドは pulActualSize 内の文字列のサイズを返します。

[in] ulMaxBufferSize

pchBuffer のサイズ (バイト単位)

[out] pulActualSize

文字列の実際の長さをバイト単位で受け取ります (終端の NULL を含む)。

[out] pType

DVD_TextStringType列挙体のメンバーを受け取ります。 値は、映画のタイトルや曲名などのテキスト文字列の種類を示します。 このパラメーターは、 DVD_TextStringType 列挙体で定義されていない値を受け取ることもできます。

戻り値

次のいずれかの HRESULT 値を返します。

注釈

このメソッドは、変換なしで、DVD テキスト文字列を生のバイト配列として返します。 このメソッドを使用すると、Unicode または 7 ビット ASCII (ISO/IEC 646) 以外の文字セット (JIS ローマ字漢字など) を使用してエンコードされたテキスト文字列を取得できます。 文字セットを検索するには、 IDvdInfo2::GetDVDTextLanguageInfo を呼び出します。

Unicode および ASCII テキスト文字列の場合は、ワイド文字列を返す IDvdInfo2::GetDVDTextStringAsUnicode メソッドを使用できます。

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

要件

こちらもご覧ください

DVD アプリケーション

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

IDvdInfo2 インターフェイス

DVD テキスト文字列の操作