Export (0) Print
Expand All

IDvdGraphBuilder::GetDvdInterface method

The GetDvdInterface method retrieves interfaces from the DVD-Video playback graph to make DVD-Video playback development easier.

Syntax


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

Parameters

riid [in]

IID of the requested interface.

ppvIF [out]

Receives a pointer to the interface. The application must release the interface.

Return value

Returns an HRESULT value. Possible values include the following.

Return codeDescription
E_INVALIDARG

The ppvIF parameter is invalid. This parameter must not be NULL.

E_NOINTERFACE

The requested interface could not be returned.

VFW_E_DVD_GRAPHNOTREADY

The graph is not built yet. See Remarks.

 

Remarks

You can use this method to select and configure a video renderer filter before you build the filter graph for DVD playback. The following interfaces are available:

If you call GetDvdInterface to get any of these interfaces before you build the filter graph, the DVD Graph Builder creates the appropriate video renderer. It will use this renderer later when you build the graph. After the video renderer has been selected, you can no longer retrieve the interfaces for the other video renderers. (The GetDvdInterface method will return E_NOINTERFACE.)

Before the DVD playback graph is built, if you request any interfaces that are not on the previous list, the method returns VFW_E_DVD_GRAPHNOTREADY. To build the DVD graph, call IDvdGraphBuilder::RenderDvdVideoVolume. After you build the graph, you can use GetDvdInterface to retrieve some additional interfaces:

To get other interfaces, call IDvdGraphBuilder::GetFiltergraph. Query the returned IGraphBuilder interface or use EnumFilters to enumerate the filters.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

DVD Applications
Error and Success Codes
IDvdGraphBuilder Interface

 

 

Community Additions

ADD
Show:
© 2014 Microsoft