IDvdInfo2

IDvdInfo2 インターフェイスは、DVD ディスクの属性、または DVD の再生およびナビゲーションの現在の状態を報告します。

GetCurrentDomain メソッドは、DVD Navigator が現在位置しているドメインを取得します。

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

このメソッドを使用すると、DVD Navigator が特定のタイトルドメインでの再生を終了したかどうかを判定できます。アプリケーションは、PlayTitle や PlayForwards などの IDvdControl2 メソッドを呼び出す前に、現在のドメインを確認する必要はありません。DVD Navigator はドメインを確認し、現在のコマンドがそのドメインで無効な場合は、単に何も行わずに VFW_E_DVD_INVALIDDOMAIN を返します。

GetCurrentLocation メソッドは、現在の再生位置を取得します。

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

このメソッドは、現在の位置へのシークが明示的に無効化されていないタイトルにおいて、現在の再生位置からビデオの再生を再開するのに十分な情報を取得します。ディスクが取り出された後は、このメソッドが返す情報だけでは再生を再開するのに十分でない場合があります。ユーザーが後から任意のタイミングで同じ位置に戻れるように、現在の位置と状態情報をディスクに保存するには、GetState を使用します。

GetTotalTitleTime メソッドは、現在のタイトルの総再生時間を取得します。

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

総タイトル時間とは、静止画や一時停止などを含めずに、タイトルを順次再生するのに要する時間です。

このメソッドは、1 つの連続ビデオタイトル（各チャプターが自動的に次のチャプターへ分岐し、タイトル全体が停止することなく連続再生される、映画などのタイトル）でのみ使用します。非連続ビデオタイトルとは、チャプターが自動的に次々と再生されないタイトルです。DVD のオーサリング担当者が非連続ビデオタイトルに時間情報をエンコードする方法にはばらつきがあるため、そのようなタイトルの総時間を求めるためにこのメソッドを使用しないでください。

GetCurrentButton メソッドは、利用可能なボタンの数と、現在選択されているボタンの番号を取得します。

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

ボタンが存在しない場合、pulButtonsAvailable と pulCurrentButton の両方が 0 に設定されます。

GetCurrentAngle メソッドは、現在のアングルブロックで利用可能なアングルの数と、現在選択されているアングル番号を取得します。

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

アングルとメニューボタンのインデックスは 1 から始まるのに対し、オーディオおよびサブピクチャーストリームのインデックスは 0 から始まる点に注意してください。DVD Navigator はアングルブロックに入ろうとするとき、lParam を 1 に設定した EC_DVD_ANGLES_AVAILABLE イベント通知をアプリケーションに送信します。アプリケーションは通常、EC_DVD_ANGLES_AVAILABLE のイベントハンドラー内で GetCurrentAngle と IDvdControl2::SelectAngle を呼び出します。

このメソッドの使用例は、DVDSample アプリケーションの CAngleDlg::MakeAngleList で示されています。

GetCurrentAudio メソッドは、利用可能なオーディオストリームの数と、現在選択されているオーディオストリームの番号を取得します。

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

ディスク上で利用可能なオーディオ言語を取得するには、GetCurrentAudio を呼び出した後、0 から (pulStreamsAvailable - 1) までの各ストリームに対して GetAudioLanguage を呼び出し、言語情報を取得します。

GetCurrentSubpicture メソッドは、現在のタイトルで利用可能なサブピクチャーストリームの数、現在選択されているサブピクチャーストリーム番号、およびサブピクチャーの状態を取得します。

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

DVD コンテンツのオーサリング担当者は、ディスク上の特定のサブピクチャーストリームを強制的に有効化されるものとして指定できます。これは、視聴者が視聴を望むかどうかにかかわらず、DVD のオーサリング担当者がそのストリームを表示するよう要求することを意味します。DVD Navigator はディスクからのそのようなコマンドすべてに従うため、アプリケーションが IDvdControl2::SetSubpictureState メソッドでサブピクチャー表示を無効にしていても、強制的に有効化されたストリームは表示されます。

GetCurrentUOPS メソッドは、コンテンツのオーサリング担当者が現在のディスク位置に対して明示的に無効化したナビゲーションコマンド（存在する場合）を示すフラグのセットを取得します。

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

DVD のオーサリング担当者は、現在の DVD ドメイン内では本来許可されるナビゲーションコマンドを禁止するために、ディスク上のほぼ任意の場所に UOP コマンドを挿入できます。言い換えると、UOP コマンドを使用すると、ディスクのオーサリング担当者は通常のナビゲーション権限を上書きできます。

DVD Navigator は任意のコマンドを実行する前にすべての UOP 権限を自動的にチェックし、現在の UOP でコマンドが無効な場合はいずれのメソッドからも VFW_E_DVD_OPERATION_INHIBITED を返すため、DVD プレーヤーアプリケーションが通常このメソッドを使用する必要はありません。アプリケーション自身で現在の UOP 権限を追跡する必要がある場合は、現在の UOP 権限が必要になるたびに GetCurrentUOPS を呼び出すか、メッセージループ内で EC_DVD_VALID_UOPS_CHANGE イベント通知を処理し、lParam1 パラメーターから UOP 情報を取得できます。後者の方法が一般的により効率的です。

GetAllSPRMs メソッドは、すべてのシステムパラメーターレジスタ (SPRM) の現在の内容を取得します。

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

24 個の SPRM は、現在の言語、サブピクチャー、その他のナビゲーションデータに関する情報を保持するために使用されます。

GetAllGPRMs メソッドは、すべての汎用パラメーターレジスタ (GPRM) の現在の内容を取得します。

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

GPRM は 16 ビットのレジスタで、各ディスクが一時的なデータ格納のために独自の方法で使用できます。

GetAudioLanguage メソッドは、現在のタイトル内で指定されたオーディオストリームの言語を取得します。

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

このメソッドはメニューの言語を返しません。ストリームが不明な言語を含む場合、pLanguage が指す値を 0 に設定します。pLanguage から人間が読める文字列名を作成するには、GetLocaleInfo 関数を呼び出します。

LCID Language;
hr = pDvdInfo->GetAudioLanguage(ulStream, &Language);
if (SUCCEEDED(hr))
{
    int cchSize = GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, 0, 0);
    TCHAR *szString = new TCHAR[cchSize];
    if (szString)
    {
        GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, szString, cchSize);
        /* ... */
        delete [] szString;
    }
}

GetSubpictureLanguage メソッドは、現在のタイトル内で指定されたサブピクチャーストリームの言語を取得します。

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

メニューで利用可能なテキスト言語を取得するには、GetMenuLanguages を呼び出します。ストリームが不明な言語を含む場合、GetSubpictureLanguage は pLanguage が指す値を 0 に設定します。pLanguage から人間が読める文字列名を作成するには、次のように Win32 の GetLocaleInfo 関数を呼び出します。

LCID Language;
hr = pDvdInfo->GetSubpictureLanguage(ulStream, &Language);
if (SUCCEEDED(hr))
{
    int cchSize = GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, 0, 0);
    TCHAR *szString = new TCHAR[cchSize];
    if (szString)
    {
        GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, szString, cchSize);
        /* ... */
        delete [] szString;
    }
}

GetTitleAttributes メソッドは、指定されたタイトルとそのメニューについて、すべてのビデオ、オーディオ、およびサブピクチャーストリームの属性を取得します。

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

GetVMGAttributes メソッドは、Video Manager Menu について、すべてのビデオ、オーディオ、およびサブピクチャーストリームの属性を取得します。

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

Video Manager Menu は、特定のタイトル番号には関連付けられていません。

GetCurrentVideoAttributes メソッドは、現在のタイトルまたはメニューのビデオ属性を取得します。

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

このメソッドの使用例は、DVDSample アプリケーションの CDvdCore::GetVideoAttributes() で示されています。

GetAudioAttributes メソッドは、現在のタイトルまたはメニューで指定されたオーディオストリームの属性を取得します。

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

ulStream には、0 から 7 までの任意のインデックス番号、または次の値のいずれかを指定できます。

このメソッドの使用例は、DVDSample アプリケーションの CDvdCore::GetAudioAttributes と CAudioLangDlg::GetAudioLang で示されています。

GetKaraokeAttributes メソッドは、現在のタイトルまたはメニューで指定されたオーディオストリームのカラオケ属性を取得します。

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

このメソッドは、ストリーム内のチャンネル数を明示的には返しません。その情報は、IDvdInfo2::GetAudioAttributes を呼び出すことで取得できます。このメソッドの使用例は、DVDSample アプリケーションの CKaraokeDlg::DoModal で示されています。

ulStream パラメーターには、0 から 7 までの値、または次のいずれかを指定できます。

GetSubpictureAttributes メソッドは、指定されたタイトルまたはメニューで指定されたサブピクチャーストリームの属性を取得します。

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

インデックス番号 0～31 はタイトルに対してのみ有効です。メニューにはサブピクチャーストリームが 1 つしかなく、以下の表の定数のいずれかを使用して指定する必要があります。

このメソッドの使用例は、DVDSample アプリケーションの CDvdCore::GetSPAttributes() と CSPLangDlg::GetSPLang で示されています。

GetDVDVolumeInfo メソッドは、現在の DVD ボリューム情報を取得します。

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

一部のディスクは、複数ディスクセットの一部として配布されることがあります。この文脈における「ボリューム」は、ディスクのオーサリング方法に応じて、「ディスク」または「ディスク面」のいずれかを意味することがあります。

GetDVDTextNumberOfLanguages メソッドは、DVD テキスト文字列が存在する言語の数を取得します。

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

ディスクのオーサリング方法に応じて、言語数はディスク全体に対して有効な場合と、ディスクの現在の面に対してのみ有効な場合があります。

DVD にテキスト文字列が含まれていない場合、このメソッドは成功しますが、pulNumOfLangs は値 0 を受け取ります。

GetDVDTextLanguageInfo メソッドは、指定された言語のテキスト文字列に関する情報を取得します。このメソッドは、その言語の文字列数、ロケール識別子、および文字セットを取得します。

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

特定のテキスト文字列を取得するには、IDvdInfo2::GetDVDTextStringAsUnicode または IDvdInfo2::GetDVDTextStringAsNative を呼び出します。

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

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

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

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

返される文字列には、常に単一の終端 NULL バイトが含まれます。バッファーが DVD テキスト文字列の長さより小さい場合、文字列は切り詰められます。必要なバッファーサイズを調べるには、pchBuffer を NULL、ulMaxBufferSize を 0 にして、このメソッドを一度呼び出します。サイズは pulActualSize に返されます。その後、バッファーを割り当てて、このメソッドを再度呼び出します。

GetDVDTextStringAsUnicode メソッドは、指定された言語の DVD テキスト文字列を取得し、そのテキスト文字列を Unicode 文字列として返します。

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

このメソッドは、Unicode または 7 ビット ASCII (ISO/IEC 646) でエンコードされたテキスト文字列をサポートします。テキスト文字列が ASCII エンコードを使用している場合、このメソッドは文字列をワイド文字列に変換します。テキスト文字列がそれ以外の文字セットを使用している場合、このメソッドは E_FAIL を返します。その場合は、IDvdInfo2::GetDVDTextStringAsNative を呼び出して、文字列を生のバイト配列として取得できます。文字セットを調べるには、IDvdInfo2::GetDVDTextLanguageInfo を呼び出します。

返される文字列には、常に終端の NULL が含まれます。バッファーが DVD テキスト文字列の長さより小さい場合、文字列は切り詰められます。必要なバッファーサイズを調べるには、pchBuffer を NULL、ulMaxBufferSize を 0 にして、このメソッドを一度呼び出します。サイズは pulActualSize に返されます。その後、バッファーを割り当てて、このメソッドを再度呼び出します。

GetPlayerParentalLevel メソッドは、DVD Navigator の現在の視聴制限レベルと ISO 3166 国/地域コードの設定を取得します。

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

DVD Navigator では、視聴制限は既定で無効になっています。このメソッドの使用例は、DVDSample アプリケーションの CDvdCore::GetParentalLevel で示されています。

GetNumberOfChapters メソッドは、指定されたタイトル内のチャプター数を取得します。

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

有効なチャプター番号を指定できるように、IDvdControl2::PlayChapter を呼び出す前にこのメソッドを呼び出してチャプター数を取得してください。

GetTitleParentalLevels メソッドは、特定のタイトルに対して定義された視聴制限レベルを取得します。

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

1 つのタイトルには、セクションごとに異なる視聴制限レベルを含めることができます。

GetDVDDirectory メソッドは、DVD Navigator に設定されているルートディレクトリを取得します。

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

このメソッドの使用例は、DVDSample アプリケーションの CDvdCore::GetDriveLetter で示されています。

IsAudioStreamEnabled メソッドは、指定されたオーディオストリームが現在のタイトルで有効かどうかを判定します。

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

DVD は最大 8 個の個別のオーディオストリームを持つことができますが、通常、すべてのストリームが各タイトルで有効になるわけではありません。IsAudioStreamEnabled を使用して特定のストリームが現在のタイトルで有効かどうかを判定し、その後 IDvdControl2::SelectAudioStream を呼び出して有効なストリームの 1 つを選択します。

GetDiscID メソッドは、指定された DVD に対してシステムが生成した 64 ビットの識別番号を取得します。

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

DVD Navigator は、BCA (burst cutting area) の値ではなく、ファイルサイズ、日付、その他の情報に基づいて識別 ID を計算します。この番号は、ディスクを再生するたびに同じであることが保証されます。この ID は、ディスクのすべての複製コピーに適用されます。言い換えると、特定の映画のすべてのコピーは同じ ID を持ちます。2 つの異なるタイトルが同じ ID を持つ可能性は十分に低いため、この ID は実用上「一意」とみなすことができます。

GetState メソッドは、ディスクの位置と DVD Navigator の状態情報を含むブックマークを取得します。

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

このメソッドが呼び出されると、DVD Navigator は新しい状態オブジェクトを作成し、現在の位置、現在の視聴制限レベル、その他の状態情報をそこに保存します。DVDState オブジェクトを使用すると、IDvdControl2::SetState の呼び出しによって、後から DVD Navigator を保存された位置に復元できます。これにより、視聴者はディスクの途中で視聴を中断して位置を保存し、後から戻って、すべての内部設定が以前のまま復元された状態で、中断した位置から視聴を開始できます。

DVD Navigator は、DvdState オブジェクトをアプリケーションに返す前に、そのオブジェクトに対して AddRef を呼び出します。アプリケーションは、そのオブジェクトの使用を終えたら、Release を呼び出す必要があります。

このメソッドの使用例は、DVDSample アプリケーションの CDvdCore::RestoreBookmark で示されています。

GetMenuLanguages メソッドは、ディスク上のすべてのメニューで利用可能なすべての言語を取得します。

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

GetButtonAtPosition メソッドは、表示ウィンドウ内の指定された位置にあるボタンを取得します。

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

このメソッドは通常、DVD メニュー表示ウィンドウ内でのマウスポインターの移動に応じて呼び出されます。ボタン番号を取得しようとする前に、必ず HRESULT で成功を確認してください。このメソッドは、指定された位置にボタンが見つかった場合にのみ puButtonIndex の値を設定します。DVD のボタンは必ずしも強調表示された矩形を持つとは限らず、ボタンの矩形は重なり合うことがあり、また、ボタンの矩形が常にボタンの視覚的表現に対応するとは限りません。

GetCmdFromEvent メソッドは、EC_DVD_CMD_START または EC_DVD_CMD_END イベントから IDvdCmd オブジェクトを取得します。

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

このメソッドは、EC_DVD_CMD_START または EC_DVD_CMD_END イベントの lParam1 パラメーターを、イベントを発生させたコマンドに関連付けられた IDvdCmd オブジェクトにマップします。その後、WaitForStart または WaitForEnd を呼び出して、そのコマンドに関する DVD Navigator のブロッキング動作を制御できます。IDvdCmd オブジェクトは DVD Navigator によって作成され、返されるポインターは既に参照カウントがインクリメントされているため、WaitForStart または WaitForEnd が返された後に解放する必要があります。

GetDefaultMenuLanguage メソッドは、既定のメニュー言語を取得します。

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

GetDefaultAudioLanguage メソッドは、既定のオーディオ言語を取得します。

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

GetDefaultSubpictureLanguage メソッドは、既定のサブピクチャー言語を取得します。

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

GetDecoderCaps メソッドは、DVD デコーダーのビデオ、オーディオ、およびサブピクチャーの最大データレート（順方向および逆方向）に加えて、さまざまな種類のオーディオ (AC-3, MPEG-2, DTS, SDDS, LPCM) のサポート状況を取得します。

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

GetButtonRect メソッドは、指定されたメニューボタンの矩形座標を取得します。注意 このメソッドは現在実装されていません。

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

IsSubpictureStreamEnabled メソッドは、指定されたサブピクチャーストリームが現在のタイトルで有効かどうかを判定します。

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

DVD は最大 32 個の個別のサブピクチャーストリームを持つことができますが、通常、すべてのストリームが各タイトルで有効になるわけではありません。IsSubpictureStreamEnabled を使用して特定のストリームが現在のタイトルで有効かどうかを判定し、その後 IDvdControl2::SelectSubpictureStream を呼び出して有効なストリームの 1 つを選択します。