Microsoft DirectX 8.0

IDvdControl インターフェイス

注 :  このインターフェイスの使用は避けること。既存のアプリケーションとの後方互換性を保つため、継続してサポートされるが、新しいアプリケーションでは IDvdControl2 を使用すること。

IDvdControl インターフェイスでは、1 つ以上のビデオ ムービーから構成される DVD タイトルの再生とサーチのメカニズムを制御する。

DVD ファイル システムは、作成者が簡単にカスタマイズできない連続的なトラックから構成される CD-ROM などのフォーマットとは大きく異なる。DVD フォーマットのメディア ファイルの作成者は、メディア ファイル自体が備える多くの構成要素と制御メカニズムを利用して、必要に応じて再生順序を変更できるため、トラックのレイアウトとナビゲーションを従来のメディアよりはるかに正確に制御できる。また、時間 (時、分、秒、フレーム) またはチャプター値を基準にしてファイルの特定の部分を検索できる。

メディア ファイルはプログラム チェーン (PGC) のリストから構成されている。個々のプログラム チェーンはプログラムのリストから構成されており、個々のプログラムはセルのリストから構成されており、個々のセルはビデオ オブジェクト ユニット (VOBU) のリストから構成されており、個々のビデオ オブジェクト ユニットはパックのリストから構成されており、個々のパックは実際の MPEG データから構成されている。

このインターフェイスは、DVD の再生に対応するために Microsoft® DirectShow® DVD ナビゲータによって実装される。

このインターフェイスを使用して、再生を制御したり (ルート ドライブの設定、再生、停止など)、DVD-Video ファイルの再生時にメニューやボタンなど、DVD 固有の機能を利用する。

vtable 順のメソッド

IUnknown メソッド説明
QueryInterface サポートされているインターフェイスへのポインタを取得する。
AddRef 参照カウントをインクリメントする。
Release 参照カウントをデクリメントする。
IDvdControl methods説明
TitlePlay 指定されたタイトル インデックスを持つメディア ファイルを検索し、それを再生する。
ChapterPlay 指定されたタイトル インデックスとチャプター値を持つメディア ファイルを再生する。
TimePlay 指定されたタイトル インデックスを持つメディア ファイルの指定された時間から再生を開始する。
StopForResume 再開情報を保存した後、再生を DVD_DOMAIN_Stop 状態に移行させる。
GoUp 現在のメディア ファイルの再生を停止し、指定された前のプログラム チェーン (PGC) の再生を開始する。
TimeSearch 現在のチャプターの再生を停止し、同じメディア ファイルの指定された時間から再生を開始する。
ChapterSearch 現在のチャプターの再生を停止し、同じメディア ファイルの指定されたチャプター値から再生を開始する。
PrevPGSearch 現在のプログラムの再生を停止し、プログラム チェーン (PGC) 内の前のプログラムから再生を開始する。
TopPGSearch 現在のプログラムの再生を停止し、プログラム チェーン内の現在のプログラムの再生を再び開始する。
NextPGSearch 現在のプログラムの再生を停止し、プログラム チェーン (PGC) 内の次のプログラムから再生を開始する。
ForwardScan 指定された速度で現在のディスクを順方向にサーチする。
BackwardScan 指定された速度で現在のディスクを逆方向にサーチする。
MenuCall 指定されたメニューを画面上に表示する。
Resume メニューを使ったタイトルの再生に戻る。
UpperButtonSelect 表示されたメニューから上方向ボタンを選択する。
LowerButtonSelect 表示されたメニューから下方向ボタンを選択する。
LeftButtonSelect 表示されたメニューから左方向ボタンを選択する。
RightButtonSelect 表示されたメニューから右方向ボタンを選択する。
ButtonActivate 選択されているボタンをアクティブにする。
ButtonSelectAndActivate 指定されたボタンを選択し、アクティブにする。
StillOff 再生を再開し、静止モードをキャンセルする。
PauseOn 現在のメディア ファイルの再生をポーズする。
PauseOff 現在のメディア ファイルの再生ポーズを解除する。
MenuLanguageSelect ナビゲーション メニューに表示される言語を設定する。
AudioStreamChange 現在のオーディオ ストリームを設定する。
SubpictureStreamChange 新しいサブピクチャ ストリームを選択し、その表示を有効または無効にする。
AngleChange 新しい表示アングルを設定する。
ParentalLevelSelect 現在のメディア ファイルのペアレンタル ロック アクセス レベルを設定する。
ParentalCountrySelect ペアレンタル ロック アクセス レベルを制御するときの基準となる現在の国を設定する。
KaraokeAudioPresentationModeChange オーディオ再生モードをカラオケに設定する。
VideoModePreferrence ユーザーの好みのビデオ表示モードを設定する。
SetRoot DVD-Video ボリュームが格納されているルート ディレクトリを設定する。
MouseActivate マウスのクリックに応じて DVD ボタンを選択し、アクティブにする。
MouseSelect マウスの移動に応じて DVD ボタンを選択する。
ChapterPlayAutoStop 指定されたタイトル内の指定されたチャプターから再生を開始し、指定された数のチャプターを再生する。

IDvdControl::AngleChange

IDvdControl インターフェイス

新しい表示アングルを設定する。

構文

HRESULT AngleChange(
    ULONG ulAngle
);

パラメータ

ulAngle
[in] 新しいアングルの値。1 から 9 の間でなければならない。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、DVD_DOMAIN_Title、または DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::AudioStreamChange

IDvdControl インターフェイス

現在のオーディオ ストリームを設定する。

構文

HRESULT AudioStreamChange(
    ULONG nAudio
);

パラメータ

nAudio
[in] 使用するオーディオ トラックを指定する値。0 から 7 の間でなければならない。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、DVD_DOMAIN_Title、または DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

AudioStreamChange は現在のビデオ タイトル セット (VTS) を対象とする。メニュー内からこのメソッドを呼び出した場合は、メニューを呼び出したタイトルのオーディオ ストリームが設定される。

IDvdControl::BackwardScan

IDvdControl インターフェイス

指定された速度で現在のディスクを逆方向にサーチする。

構文

HRESULT BackwardScan(
    double dwSpeed
);

パラメータ

dwSpeed
[in] DirectShow でメディア ファイルをサーチするときの速度を指定する値。この値は、作成されたときの速度を 1.0 とする乗数である。したがって、2.5 を指定すると、作成速度の 2.5 倍の速度で逆方向のサーチが行われ、0.5 を指定すると作成速度の半分の速度で逆方向のサーチが行われる。実際の再生速度は、ビデオ デコーダの機能によって異なり、指定された速度と異なることがある。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::ButtonActivate

IDvdControl インターフェイス

選択されているボタンをアクティブにする。

構文

HRESULT ButtonActivate(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

DVD ボタンを "選択" しても、ボタンが強調表示されるだけで "アクティブ" にはならない。選択するとは、Microsoft® Windows® でいえば、Tab キーでボタンを選択し、Space キーまたは Enter キーを押さないことと同じである。アクティブとは、Windows の場合に、ボタンを (Tab キーで) 選択した後に Space キーまたは Enter キーを押すことと同じである。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

参照

IDvdControl::ButtonSelectAndActivate

IDvdControl::ButtonSelectAndActivate

IDvdControl インターフェイス

指定されたボタンを選択し、アクティブにする。

構文

HRESULT ButtonSelectAndActivate(
    ULONG uiButton
);

パラメータ

uiButton
[in] 選択し、アクティブにするボタンを指定する値。1 から 36 の間でなければならない。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

電子的なリモート コントロール デバイスは、通常、DVD 再生装置のさまざまな機能をアクティブにするための数多くのボタンを備えている。このメソッドは、通常、ユーザーがコントロール デバイスのボタンをクリックしたときに呼び出される。このメソッドが呼び出されると、DirectShow は、たとえば、音を鳴らしたり画像を変更したりすることによってボタンが選択されたことを示し、選択されているボタンに対応する ButtonActivate などのメソッドを呼び出す。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::ChapterPlay

IDvdControl インターフェイス

指定されたタイトル インデックスとチャプター値を持つメディア ファイルを再生する。

構文

HRESULT ChapterPlay(
    ULONG uiTitle,
    ULONG uiChapter
);

パラメータ

uiTitle
[in] DirectShow が再生するタイトル番号を指定する値。1 から 99 の間でなければならない。
uiChapter
[in] 指定されたタイトル内の DirectShow が再生を開始するチャプターを指定する値。1 から 999 の間でなければならない。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、DVD_DOMAIN_Title、または DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::ChapterPlayAutoStop

IDvdControl インターフェイス

指定されたタイトル内の指定されたチャプターから再生を開始し、指定された数のチャプターを再生するように DVD プレーヤーに指示する。

構文

HRESULT ChapterPlayAutoStop(
    ULONG ulTitle,
    ULONG ulChapter,
    ULONG ulChaptersToPlay
);

パラメータ

ulTitle
[in] 再生するタイトル番号。
ulChapter
[in] 再生を開始するチャプター番号。
ulChaptersToPlay
[in] 開始チャプターから再生するチャプターの数。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、いずれのドメインでも有効である。詳細については、「DVD_DOMAIN」を参照すること。

チャプターは 1 から 999 の範囲である。詳細については「EC_DVD_CHAPTER_AUTOSTOP」を参照すること。

IDvdControl::ChapterSearch

IDvdControl インターフェイス

現在のチャプターの再生を停止し、同じタイトル内の指定されたチャプターから再生を開始する。

構文

HRESULT ChapterSearch(
    ULONG Chapter
);

パラメータ

Chapter
再生の開始位置を指定するチャプター値。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::ForwardScan

IDvdControl インターフェイス

指定された速度で現在のディスクを順方向にサーチする。

構文

HRESULT ForwardScan(
    double dwSpeed
);

パラメータ

dwSpeed
[in] DirectShow でメディア ファイルをサーチするときの速度を指定する値。この値は、作成されたときの速度を 1.0 とする乗数である。したがって、2.5 を指定すると、作成速度の 2.5 倍の速度で順方向のサーチが行われ、0.5 を指定すると作成速度の半分の速度で順方向のサーチが行われる。実際の再生速度は、ビデオ デコーダの機能によって異なり、指定された速度と異なることがある。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::GoUp

IDvdControl インターフェイス

現在のメディア ファイルの再生を停止し、指定された前のプログラム チェーン (PGC) の再生を開始する。

構文

HRESULT GoUp(void);

戻り値

HRESULT 値を返す。

注意

個々の PGC は作成時に前の PGC に関連付けられる。このメソッドは、関連付けられた前の PGC を新しい再生ファイルとして設定する。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::KaraokeAudioPresentationModeChange

IDvdControl インターフェイス

オーディオ再生モードをカラオケに設定する。

構文

HRESULT KaraokeAudioPresentationModeChange(
    ULONG ulMode
);

パラメータ

ulMode
[in] 要求されているオーディオ再生モード。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

現在、カラオケのサポートは実装されていない。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、DVD_DOMAIN_Title、または DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::LeftButtonSelect

IDvdControl インターフェイス

表示されたメニューから左方向ボタンを選択する。

構文

HRESULT LeftButtonSelect(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

多くの場合、物理的または電子的なリモート コントロール デバイスには、メニューの選択など、特定の種類の操作に使われる 4 個の方向ボタンが付属している。このメソッドは、何か (多くの場合はユーザー) によって、左方向ボタンがトリガされたことを DirectShow に知らせる。

DVD ボタンを "選択" しても、ボタンが強調表示されるだけで "アクティブ" にはならない。選択するとは、Windows でいえば、Tab キーでボタンを選択し、Space キーまたは Enter キーを押さないことと同じである。アクティブとは、Windows の場合に、ボタンを (Tab キーで) 選択した後に Space キーまたは Enter キーを押すことと同じである。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::LowerButtonSelect

IDvdControl インターフェイス

表示されたメニューから下方向ボタンを選択する。

構文

HRESULT LowerButtonSelect(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

多くの場合、物理的または電子的なリモート コントロール デバイスには、メニューの選択など、特定の種類の操作に使われる 4 個の方向ボタンが付属している。このメソッドは、何か (多くの場合はユーザー) によって、下方向ボタンがトリガされたことを DirectShow に知らせる。

DVD ボタンを "選択" しても、ボタンが強調表示されるだけで "アクティブ" にはならない。選択するとは、Windows でいえば、Tab キーでボタンを選択し、Space キーまたは Enter キーを押さないことと同じである。アクティブとは、Windows の場合に、ボタンを (Tab キーで) 選択した後に Space キーまたは Enter キーを押すことと同じである。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::MenuCall

IDvdControl インターフェイス

指定されたメニューを画面上に表示する。

構文

HRESULT MenuCall(
    DVD_MENU_ID MenuID
);

パラメータ

MenuID
[in] 表示するメニューを指定する値。DVD_MENU_ID 列挙型のメンバである。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、DVD_DOMAIN_Title、または DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::MenuLanguageSelect

IDvdControl インターフェイス

ナビゲーション メニューに表示される言語を設定する。

構文

HRESULT MenuLanguageSelect(
    LCID LanguageCode
);

パラメータ

LanguageCode
新しい言語を指定する値。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、メニューのデフォルトの言語を選択する。

このメソッドは、ドメインが DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

アプリケーションは標準 Windows LCID を使って言語を指定する。

IDvdControl::MouseActivate

IDvdControl インターフェイス

マウスのクリックに応じて DVD ボタンを選択し、アクティブにする。

構文

HRESULT MouseActivate(
    POINT point );

パラメータ

point
[in] 表示ウィンドウ内の指定された位置。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、表示ウィンドウ内の指定された位置が現在の DVD ボタンの四角い強調表示領域内にあるかどうかを確認する。指定された位置が強調表示領域内にある場合、このメソッドはそのボタンを選択し、アクティブにする。

DVD ボタンの中には、強調表示領域がないものもある。ボタンの強調表示領域どうしは重なることがあり、強調表示領域が DVD ボタンの外観と一致しないこともある。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::MouseSelect

IDvdControl インターフェイス

マウスの移動に応じて DVD ボタンを選択する。

構文

HRESULT MouseSelect(
    POINT point );

パラメータ

point
[in] 表示ウィンドウ内の指定された位置。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、いずれのドメインでも有効である。詳細については、「DVD_DOMAIN」を参照すること。

このメソッドは、表示ウィンドウ内の指定された位置が現在の DVD ボタンの四角い強調表示領域内にあるかどうかを確認する。指定された位置が強調表示領域内にある場合、このメソッドはそのボタンを選択し、アクティブにする。

DVD ボタンの中には、強調表示領域がないものもある。ボタンの強調表示領域どうしは重なることがあり、強調表示領域が DVD ボタンの外観と一致しないこともある。

IDvdControl::NextPGSearch

IDvdControl インターフェイス

現在のプログラムの再生を停止し、プログラム チェーン (PGC) 内の次のプログラムから再生を開始する。

構文

HRESULT NextPGSearch(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

通常、1 つのプログラムは 1 つのチャプターに相当し、1 つの PGC は 1 つのタイトルに相当する。One_Sequential_PGC_Title の場合、各プログラムは 1 つのチャプターに相当する必要があり、各タイトルには PGC が 1 つだけ含まれるが、それ以外の場合、特にランダム/シャッフル PGC およびペアレンタル ブロックの場合は、チャプター間に複数のプログラムを含めたり、1 つのタイトルに複数の PGC を含めることができる。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::ParentalCountrySelect

IDvdControl インターフェイス

ペアレンタル ロック アクセス レベルを制御するときの基準となる現在の国を設定する。

構文

HRESULT ParentalCountrySelect(
    WORD wCountry
);

パラメータ

wCountry
[in] ISO3166 で定義されている Alpha-2 Code に従って現在の国を指定する値。「注意」を参照すること。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

wCountry パラメータの ISO3166 の 2 文字国コードは、このメソッドに WORD として渡す必要がある。以下のコードは、アメリカ (US) の場合の変換の例を示している。

WORD wCountry  =  ( WORD( 'U' ) << 8 ) | 'S';

参照

IDVDControl::ParentalLevelSelect

IDvdControl::ParentalLevelSelect

IDvdControl インターフェイス

現在のメディア ファイルのペアレンタル ロック アクセス レベルを設定する。

構文

HRESULT ParentalLevelSelect(
    ULONG ulParentalLevel
);

パラメータ

ulParentalLevel
現在のメディア ファイルのペアレンタル ロック アクセス レベルを指定する値。1 以上、8 以下の値でなければならない。以下は定義済みのペアレンタル ロック レベルである。
1格付けは一般向けの G である。
3格付けは保護者の指導が望ましい PG である。
4格付けは保護者の指導が望ましく、13 歳未満の子供には推奨できない PG-13 である。
6格付けは制限付きの R である。
7格付けは NC-17 である。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

このメソッドは、現在のユーザーのアクセス レベルを設定する。アクセス レベルによって、ユーザーが再生できるメディア ファイルが決まる。高いレベルは低いレベルのコンテンツを再生できるが、低いレベルは高いレベルのコンテンツを再生できない。たとえば、成人は子供向けのコンテンツを見ることができるが、子供は成人向けのコンテンツを見ることはできない。

DVD ナビゲータ フィルタには、ペアレンタル ロック レベルの設定を制限する機能はない。DVD プレーヤー アプリケーションでは、現在のペアレンタル ロック レベルを上げる操作をパスワードによって保護するなど、ペアレンタル ロック レベルの設定を強制的に制限することができる。DVD ナビゲータのデフォルトの設定では、ペアレンタル ロックが無効になっている。

ペアレンタル ロックを無効にするには、ulParentalLevel として 0xffffffff を渡す。ペアレンタル ロックが無効になっていれば、プレーヤーは、ペアレンタル ID に関係なく、ペアレンタル ブロック内の最初のプログラム チェーン (PGC) を再生する。

参照

IDVDControl::ParentalCountrySelect

IDvdControl::PauseOff

IDvdControl インターフェイス

ポーズ後、現在のメディア ファイルの再生を再開する。

構文

HRESULT PauseOff(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

メディア ファイルの再生がポーズになっていない場合、このメソッドは何もしない。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

参照

IDvdControl::PauseOn

IDvdControl::PauseOn

IDvdControl インターフェイス

現在のメディアファイルの再生をポーズする。

構文

HRESULT PauseOn(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

IMediaControl::Pause と同様に、このメソッドは再生とすべての内部タイマを静止させる。メディア ファイルが動作していない場合、このメソッドは何もしない。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

参照

IDvdControl::PauseOff

IDvdControl::PrevPGSearch

IDvdControl インターフェイス

現在のプログラムの再生を停止し、プログラム チェーン (PGC) 内の前のプログラムから再生を開始する。

構文

HRESULT PrevPGSearch(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

通常、1 つのプログラムは 1 つのチャプターに相当し、1 つの PGC は 1 つのタイトルに相当する。One_Sequential_PGC_Title の場合、各プログラムは 1 つのチャプターに相当する必要があり、各タイトルには PGC が 1 つだけ含まれるが、それ以外の場合、特にランダム/シャッフル PGC およびペアレンタル ブロックの場合は、チャプター間に複数のプログラムを含めたり、1 つのタイトルに複数の PGC を含めることができる。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::Resume

IDvdControl インターフェイス

メニューを使ったタイトルの再生に戻る。

構文

HRESULT Resume(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

ファイルの再生が停止している場合、またはファイルが既に動作している場合、このメソッドは何もしない。

このメソッドは、動作を DVD_DOMAIN_Title のタイトル再生に戻す。通常、アプリケーションは、DVD ナビゲータを DVD_DOMAIN_VideoTitleSetMenu または DVD_DOMAIN_VideoManagerMenu に移行させる MenuCall を呼び出した後でこのメソッドを呼び出す。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu または DVD_DOMAIN_VideoTitleSetMenu でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::RightButtonSelect

IDvdControl インターフェイス

表示されたメニューから右方向ボタンを選択する。

構文

HRESULT RightButtonSelect(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_OUTOFMEMORYメモリ不足 (バッファ スペース不足)。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

多くの場合、物理的または電子的なリモート コントロール デバイスには、メニューの選択など、特定の種類の操作に使われる 4 個の方向ボタンが付属している。このメソッドは、何か (多くの場合はユーザー) によって、右方向ボタンがトリガされたことを DirectShow に知らせる。

DVD ボタンを "選択" しても、ボタンが強調表示されるだけで "アクティブ" にはならない。選択するとは、Windows でいえば、Tab キーでボタンを選択し、Space キーまたは Enter キーを押さないことと同じである。アクティブとは、Windows の場合に、ボタンを (Tab キーで) 選択した後に Space キーまたは Enter キーを押すことと同じである。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::SetRoot

IDvdControl インターフェイス

DVD-Video ボリュームが格納されているルート ディレクトリを設定する。

構文

HRESULT SetRoot(
    LPCWSTR pszPath
);

パラメータ

pszPath
[in] ルート ディレクトリとして設定するディレクトリ名へのポインタ。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_POINTERNULL ポインタ引数。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::TitlePlay を呼び出す前にルート ディレクトリを設定しなかった場合は、最上位レベルのディレクトリに VIDEO_TS ディレクトリが含まれている C: 以降の最初のドライブがルートとして使用される。

IDvdControl::StillOff

IDvdControl インターフェイス

再生を再開し、静止モードをキャンセルする。

構文

HRESULT StillOff(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

表示画像が静止画保持モードになっていない場合、このメソッドは何もしない。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::StopForResume

IDvdControl インターフェイス

再開情報を保存した後、再生を DVD_DOMAIN_Stop 状態に移行させる。

構文

HRESULT StopForResume(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

再生されているファイルまたはポーズしているファイルがない場合、このメソッドは何もしない。

DVD ナビゲータ フィルタは停止状態に移行するが、フィルタのグラフは DirectShow 実行状態にとどまる。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::SubpictureStreamChange

IDvdControl インターフェイス

新しいサブピクチャ ストリームを選択し、その表示を有効または無効にする。

構文

HRESULT SubpictureStreamChange(
    ULONG nSubPicture,
    BOOL bDisplay
);

パラメータ

nSubPicture
サブピクチャのソースを指定する値。0 から 32 の間または 63 でなければならない。
0-31ストリームが有効であることを示す。
32現在のストリームを変更せずに表示をオン、オフできる。つまり、現在のストリームを変更せずに bDisplay を変更できる。
63ストリームがダミー ストリームであることを示す。
bDisplay
サブピクチャが有効であるかどうかを指定する値。TRUE に設定すると、サブピクチャが表示され、FALSE に設定するとサブピクチャが表示されない。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、DVD_DOMAIN_Title、または DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::TimePlay

IDvdControl インターフェイス

指定されたタイトル インデックスを持つメディア ファイルの指定された時間から再生を開始する。

構文

HRESULT TimePlay(
    ULONG uiTitle,
    ULONG bcdTime
);

パラメータ

uiTitle
DirectShow で再生するタイトル番号を指定する値。この値は 1 から 99 の間でなければならない。
bcdTime
DirectShow が再生を開始する DVD_TIMECODE 構造体へのポインタ。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、DVD_DOMAIN_Title、または DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::TimeSearch

IDvdControl インターフェイス

現在のチャプターの再生を停止し、同じメディア ファイルの指定された時間から再生を開始する。

構文

HRESULT TimeSearch(
    ULONG bcdTime
);

パラメータ

bcdTime
DirectShow が再生を開始する DVD_TIMECODE 構造体へのポインタ。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::TitlePlay

IDvdControl インターフェイス

指定されたタイトル インデックスを持つメディア ファイルを検索し、それを再生する。

構文

HRESULT TitlePlay(
    ULONG uiTitle
);

パラメータ

uiTitle
DirectShow で再生するタイトル番号を指定する値。この値は 1 から 99 の間でなければならない。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、DVD_DOMAIN_Title、または DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::TopPGSearch

IDvdControl インターフェイス

現在のプログラムの再生を停止し、プログラム チェーン (PGC) 内の現在のプログラムの再生を再び開始する。

構文

HRESULT TopPGSearch(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
E_UNEXPECTEDDVD が初期化されていない。
S_OK成功。

注意

通常、1 つのプログラムは 1 つのチャプターに相当し、1 つの PGC は 1 つのタイトルに相当する。One_Sequential_PGC_Title の場合、各プログラムは 1 つのチャプターに相当する必要があり、各タイトルには PGC が 1 つだけ含まれるが、それ以外の場合、特にランダム/シャッフル PGC およびペアレンタル ブロックの場合は、チャプター間に複数のプログラムを含めたり、1 つのタイトルに複数の PGC を含めることができる。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::UpperButtonSelect

IDvdControl インターフェイス

表示されたメニューから上方向ボタンを選択する。

構文

HRESULT UpperButtonSelect(void);

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_NOTIMPLメソッドがサポートされていない。
S_OK成功。

注意

多くの場合、物理的または電子的なリモート コントロール デバイスには、メニューの選択など、特定の種類の操作に使われる 4 個の方向ボタンが付属している。このメソッドは、何か (多くの場合はユーザー) によって、上方向ボタンがトリガされたことを DirectShow に知らせる。

DVD ボタンを "選択" しても、ボタンが強調表示されるだけで "アクティブ" にはならない。選択するとは、Windows でいえば、Tab キーでボタンを選択し、Space キーまたは Enter キーを押さないことと同じである。アクティブとは、Windows の場合に、ボタンを (Tab キーで) 選択した後に Space キーまたは Enter キーを押すことと同じである。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、または DVD_DOMAIN_Title でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。

IDvdControl::VideoModePreferrence

IDvdControl インターフェイス

ユーザーの好みのビデオ表示モードを設定する。

構文

HRESULT VideoModePreferrence(
    ULONG ulPreferredDisplayMode
);

パラメータ

ulPreferredDisplayMode
[in] DVD コンテンツの新しい表示モードを指定する値。DVD_PREFERRED_DISPLAY_MODE 列挙型のメンバである。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。通常の戻り値は次のいずれかである。
E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
S_OK成功。

注意

このメソッドは、デフォルトのビデオ ウィンドウのアスペクト比を変更する。このメソッドによってデフォルトのアスペクト比変換メカニズムを指定することもできる。

このメソッドは、ドメインが DVD_DOMAIN_VideoManagerMenu、DVD_DOMAIN_VideoTitleSetMenu、DVD_DOMAIN_Title、または DVD_DOMAIN_Stop でない限りエラーを返す。詳細については、「DVD_DOMAIN」を参照すること。