IDvdGraphBuilder::GetDvdInterface メソッド (strmif.h)

  • [アーティクル]

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

GetDvdInterface メソッドは、DVD-Video再生グラフからインターフェイスを取得して、DVD-Video再生開発を容易にします。

構文

HRESULT GetDvdInterface(
  [in]  REFIID riid,
  [out] void   **ppvIF
);

パラメーター

[in] riid

要求されたインターフェイスの IID。

[out] ppvIF

インターフェイスへのポインターを受け取ります。 アプリケーションはインターフェイスを解放する必要があります。

戻り値

HRESULT 値を返します。 使用可能な値は次のとおりです。

リターン コード 説明
E_INVALIDARG
 ppvIF パラメーターが無効です。 このパラメーターは NULL にすることはできません。
E_NOINTERFACE
 要求されたインターフェイスを返できませんでした。
VFW_E_DVD_GRAPHNOTREADY
 グラフはまだ構築されていません。 「解説」を参照してください。

Remarks

DVD 再生用のフィルター グラフを作成する前に、このメソッドを使用してビデオ レンダラー フィルターを選択して構成できます。 次のインターフェイスを使用できます。

フィルター グラフを作成する前に GetDvdInterface を呼び出してこれらのインターフェイスのいずれかを取得すると、DVD Graph Builder によって適切なビデオ レンダラーが作成されます。 このレンダラーは、後でグラフを作成するときに使用されます。 ビデオ レンダラーを選択すると、他のビデオ レンダラーのインターフェイスを取得できなくなります。 ( GetDvdInterface メソッドはE_NOINTERFACEを返します)。

DVD 再生グラフが作成される前に、前のリストにないインターフェイスを要求すると、 メソッドは VFW_E_DVD_GRAPHNOTREADYを返します。 DVD グラフをビルドするには、 IDvdGraphBuilder::RenderDvdVideoVolume を呼び出します。 グラフをビルドした後、 GetDvdInterface を 使用して、いくつかの追加のインターフェイスを取得できます。

  • DVD 再生を制御するための IDvdControl (非推奨)、IDvdControl2、IDvdInfo (非推奨)、IDvdInfo2。
  • ウィンドウ モードでのみ、ビデオ設定を制御する IVideoWindow、IBasicVideo、IBasicVideo2。
  • オーディオ設定を制御する IBasicAudio。
  • 閉じたキャプション表示を制御する IAMLine21Decoder。
  • IMixerPinConfig と IMixerPinConfig2 を使用して、プライマリ ビデオ ストリームを配信するオーバーレイ ミキサー フィルターの最初の入力ピンを構成します。 (オーバーレイ ミキサーの他のピンのこのインターフェイスを取得するには、フィルターのピンを列挙し、直接クエリを実行します。新しいアプリケーションでは、オーバーレイ ミキサー フィルターの使用を避ける必要があります。
他のインターフェイスを取得するには、 IDvdGraphBuilder::GetFiltergraph を呼び出します。 返された IGraphBuilder インターフェイスに対してクエリを実行するか 、EnumFilters を使用してフィルターを列挙します。

要件

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

関連項目

DVD アプリケーション

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

IDvdGraphBuilder インターフェイス