IDvdControl2::SetDVDDirectory メソッド (strmif.h)

  • [アーティクル]

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

メソッドは SetDVDDirectory 、DVD ナビゲーター フィルターの読み取り元となる DVD ドライブを設定します。

構文

HRESULT SetDVDDirectory(
  [in] LPCWSTR pszwPath
);

パラメーター

[in] pszwPath

ルート ディレクトリのパスを指定するワイド文字列へのポインター。

戻り値

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

リターン コード 説明
S_OK
 成功しました。
E_INVALIDARG
 pszwPath パラメーターが無効な DVD パスを指しているか、列挙中に DVD ドライブが見つかりません。
E_UNEXPECTED
 DVD ナビゲーターが初期化されていません。
VFW_E_DVD_INVALIDDOMAIN
 ドメインが無効です。 詳細については、「解説」を参照してください。

解説

pszwPath が NULL の場合、DVD ナビゲーターは使用可能なドライブの DVD ボリュームの選択を試みます。 起動時に、DVD ナビゲーターは、ルート フォルダーに VIDEO_TS フォルダーがあるドライブ (ドライブ C 以降) を自動的に検索します。 したがって、1 台のマシンに複数の DVD ドライブがある場合、または DVD ドライブ文字が A または B の場合にのみ、 を呼び出す SetDVDDirectory 必要があります。パスを指定する場合は、video_ts フォルダーを含めます。

C++ 
SetDVDDirectory(L"e:\\video_ts");
一部の DVD ボリュームでは、"video_ts" 以外の名前のディレクトリにビデオが含まれる場合があります。 一般的な考え方は、追加の "DVD ボリューム" (のセット) です。Ifo。VOB、および 。通常は VIDEO_TS ディレクトリ) に格納される BUP ファイルは、ディスク上のサブディレクトリに配置できます。このディレクトリを指すルートを変更すると、MSWebDVD はこの個別の DVD ボリュームで動作します。 VIDEO_TS ルート内のタイトルに関係なく、新しいメニュー、タイトルなどのセットが使用可能になり、アクセスできなくなります。 このようなディレクトリは"隠しディレクトリ" と呼ばれます。 次の例では、隠しディレクトリをルートとして設定する方法を示します。ここで、"hidden" は、ディスク作成者がディレクトリに与えた名前のプレースホルダーです。
C++ 
SetDVDDirectory(L"d:\\webdvd\\hidden");
フィルター グラフが実行されていて、DVD ナビゲーターが pszwPath で指定されたディレクトリで DVD を見つけた場合、DVD ナビゲーターはディスクの再生を自動的に開始します。これは DVD 仕様に準拠しており、新しいディスクが正しく初期化されていることを確認します。 戻り値の後 SetDVDDirectory に新しいディスクを自動的に再生しない場合は、 IDvdControl2::SetOption のDVD_ResetOnStop フラグを TRUE に設定し、フィルター グラフ マネージャーで IMediaControl::Stop を呼び出してフィルター グラフを停止する必要があります。 DVD_ResetOnStopが FALSE に設定されている場合は、 SetDVDDirectory VFW_E_DVD_INVALIDDOMAINを返します。

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

次の表は、このメソッド名が対応する Annex J コマンド名と、このメソッドが有効なドメインを示しています。

Annex J コマンド名 有効なドメイン
なし DVD_DOMAIN_Stop

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

関連項目

DVD アプリケーション

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

IDvdControl2 インターフェイス