DVD テキスト文字列の操作

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

一部の DVD ディスク (特にカラオケ ディスク) には、ビデオまたはオーディオ コンテンツを補完するテキスト文字列の一覧が含まれている場合があります。 これらのテキスト文字列には、曲のタイトル、アーティスト名、ジャンル情報など、コンテンツに関するメタデータが含まれます。 テキスト文字列は複数の言語で存在できます。 これらの文字列は省略可能であり、多くのディスクには含まれていません。

DVD からテキスト文字列を取得するには、DVD ナビゲーターによって公開される IDvdInfo2 インターフェイスを使用 します。 実際には、テキスト文字列を取得するために DVD 再生グラフを作成する必要はありません。 DVD ナビゲーターを作成し、DVD ボリュームを設定してから、関連するテキスト文字列メソッドを呼び出すだけです。

テキスト文字列を取得するための基本的な手順を次に示します。

1. IDvdInfo2::GetDVDTextNumberOfLanguages を呼び出して、テキスト文字列が表示される言語の合計数を検索します。 数値が 0 の場合は、DVD にテキスト文字列がないことを意味します。 (実際には、これはおそらく最も一般的なケースです)。
2. 言語の数が 1 つ以上の場合は、 IDvdInfo2::GetDVDTextLanguageInfo を呼び出して、各言語に関する情報を取得します。 言語はインデックスによって指定されます。 このメソッドは、その言語のテキスト文字列の合計数、言語のロケール識別子 (LCID)、および文字エンコード (Unicode またはその他) を返します。 DVD テキスト文字列では、いくつかの異なる文字セットを使用できます。これらは、 DVD_TextCharSet列挙に記載されています。
3. テキスト文字列を取得するには、 IDvdInfo2::GetDVDTextStringAsUnicode または IDvdInfo2::GetDVDTextStringAsNative を呼び出します。 最初のメソッドはワイド文字列を返しますが、すべての文字セットをサポートしているわけではありません。 2 番目のメソッドは、生テキスト データを含むバイト配列を返します。 どちらのメソッドでも、 NULL バッファー ポインターを使用してメソッドを呼び出して、文字列のサイズとテキスト型を検索できます。 次に、バッファーを割り当て、もう一度メソッドを呼び出して文字列を取得します。

各テキスト文字列には、テキスト文字列の意味を示す識別子コードが関連付けられています。 識別子は 、DVD_TextStringType 値として返されます。 識別子には、 構造体識別子 と コンテンツ識別子の 2 つのカテゴリがあります。 構造体識別子の範囲には、0x00 ~ 0x02Fの数値コードがあります。 コンテンツ識別子には、0x30以上の範囲があります。 ( DVD_TextStringType 列挙型は最も一般的な識別子のサブセットを定義しますが、 IDvdInfo2 メソッドは任意の識別子コードを返すことができます)。構造体識別子は、ボリューム、タイトル、タイトルの一部 (PTT) など、DVD の論理部分を表します。 コンテンツ識別子は、映画のタイトル、曲のタイトル、ジャンルなど、特定のテキスト文字列の意味を示します。

構造体識別子には、関連付けられたテキスト文字列がありません。 テキスト文字列データに構造体識別子が表示されると、次の構造識別子まで、次のテキスト文字列が DVD の論理部分に適用されることを通知します。 テキスト・データ内の構造体 ID の位置は、DVD ボリュームの論理階層に対応します。 たとえば、DVD_Struct_Title識別子 (0x02) の最初の出現箇所はボリューム内の最初のタイトルを表し、次の出現箇所は 2 番目のタイトルを表します。

次の表は、2 つのタイトルを持つ DVD に対してテキスト文字列を定義する方法を示しています。

GetDVDTextStringAsUnicode メソッドと GetDVDTextStringAsNative メソッドは、構造体識別子とコンテンツ識別子を同じように扱います。 唯一の違いは、構造体識別子の場合、関連付けられているテキスト バッファーが空であるということです。 テキスト文字列と DVD の論理部分の関係を追跡するのは、アプリケーションにかかっています。

次の例は、DVD からテキスト文字列を取得する方法を示しています。 この例では、実際のアプリケーションに必要な詳細を無視します。 (たとえば、構造体識別子は無視されます)。この例は、正しい一連の呼び出しを表示することのみを目的としています。

#define CHECK_HR(hr) if (FAILED(hr)) { goto done; }
#define SAFE_ARRAY_DELETE(x) { if (x != NULL) { delete [] x; x = NULL; } }

HRESULT GetDVDTextStrings()
{
    HRESULT hr = S_OK;
    ULONG cLangs = 0;       // Number of languages.
    ULONG cStrings = 0;     // Number of text strings.
    ULONG cchBuffer = 0;    // Buffer size.
    ULONG cchActual = 0;    // Actual string size.

    LCID lcid;              // Locale identifier.
    DVD_TextCharSet     characterSet;
    DVD_TextStringType  stringType;

    WCHAR *pszBuffer = NULL;

    CComPtr<IBaseFilter> pFilter;
    CComPtr<IDvdInfo2> pInfo;
    CComPtr<IDvdControl2> pControl;

    // Set up the DVD Navigator.
    CHECK_HR(hr = pFilter.CoCreateInstance(CLSID_DVDNavigator));
    CHECK_HR(hr = pFilter.QueryInterface(&pInfo));
    CHECK_HR(hr = pFilter.QueryInterface(&pControl));
    CHECK_HR(hr = pControl->SetDVDDirectory(NULL));

    // Find the number of text-string languages.
    CHECK_HR(hr = pInfo->GetDVDTextNumberOfLanguages(&cLangs));
    if (cLangs == 0)
    {
        return S_FALSE; // No text strings.
    }

    // Get information about the 0'th language.
    CHECK_HR(hr = pInfo->GetDVDTextLanguageInfo(
        0, &cStrings, &lcid, &characterSet));

    // First check if this character set is compatible with the 
    // GetDVDTextStringAsUnicode method.

    if (characterSet == DVD_CharSet_Unicode || 
        characterSet == DVD_CharSet_ISO646)
    {
        // Loop through all of the strings.
        for (ULONG i = 0; i < cStrings; i++)
        {
            // Get the i'th string for the 0'th language.

            // Find the required buffer size and the string type.
            CHECK_HR(hr = pInfo->GetDVDTextStringAsUnicode(
                0,            // Language index.
                i,            // String index.
                NULL,         // Pass NULL pointer to get the buffer size.
                0,            // Size of the buffer we are passing in.
                &cchBuffer,   // Receives the required buffer size.
                &stringType   // Receives the identifier code.
                ));

            // Skip structure identifiers (0x00 - 0x2F).
            if ((cchBuffer > 0) && (stringType >= 0x30))
            {
                // Allocate a buffer and get the text string.
                pszBuffer = new WCHAR[cchBuffer];
                if (pszBuffer == NULL)
                {
                    CHECK_HR(hr = E_OUTOFMEMORY);
                }

                CHECK_HR(hr = pInfo->GetDVDTextStringAsUnicode(
                    0, i, pszBuffer, cchBuffer, &cchActual, &stringType));

                // TODO: Display the text string.

                SAFE_ARRAY_DELETE(pszBuffer);
            }
        }
    }

done:
    SAFE_ARRAY_DELETE(pszBuffer);
    return hr;
}

DVDSample アプリケーションの CDvdCore::GetDvdText メソッドは、DVD テキスト文字列を列挙して表示する基本的な手順を示しています。

関連トピック

DVD アプリケーション