Share via

Método IDvdGraphBuilder::GetDvdInterface (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método GetDvdInterface recupera interfaces do grafo de reprodução DVD-Video para facilitar o desenvolvimento de reprodução DVD-Video.

Sintaxe

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

Parâmetros

[in] riid

IID da interface solicitada.

[out] ppvIF

Recebe um ponteiro para a interface. O aplicativo deve liberar a interface.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno Descrição
E_INVALIDARG
 O parâmetro ppvIF é inválido. Esse parâmetro não deve ser NULL.
E_NOINTERFACE
 Não foi possível retornar a interface solicitada.
VFW_E_DVD_GRAPHNOTREADY
 O grafo ainda não foi criado. Consulte Observações.

Comentários

Você pode usar esse método para selecionar e configurar um filtro de renderizador de vídeo antes de criar o grafo de filtro para reprodução de DVD. As seguintes interfaces estão disponíveis:

Se você chamar GetDvdInterface para obter qualquer uma dessas interfaces antes de criar o grafo de filtro, o Construtor de Grafos de DVD criará o renderizador de vídeo apropriado. Ele usará esse renderizador posteriormente quando você compilar o grafo. Depois que o renderizador de vídeo tiver sido selecionado, você não poderá mais recuperar as interfaces dos outros renderizadores de vídeo. (O método GetDvdInterface retornará E_NOINTERFACE.)

Antes que o grafo de reprodução de DVD seja criado, se você solicitar quaisquer interfaces que não estejam na lista anterior, o método retornará VFW_E_DVD_GRAPHNOTREADY. Para criar o grafo de DVD, chame IDvdGraphBuilder::RenderDvdVideoVolume. Depois de criar o grafo, você pode usar GetDvdInterface para recuperar algumas interfaces adicionais:

  • IDvdControl (preterido), IDvdControl2, IDvdInfo (preterido) e IDvdInfo2 para controlar a reprodução de DVD.
  • IVideoWindow, IBasicVideo e IBasicVideo2 para controlar as configurações de vídeo, somente no modo de janela.
  • IBasicAudio para controlar as configurações de áudio.
  • IAMLine21Decoder para controlar a exibição de legenda fechada.
  • IMixerPinConfig e IMixerPinConfig2 para configurar o primeiro pin de entrada do filtro do Mixer de Sobreposição, que fornece o fluxo de vídeo primário. (Para obter essa interface para os outros pinos no Mixer de Sobreposição, enumere os pinos do filtro e consulte-os diretamente.) Novos aplicativos devem evitar usar o filtro Do Mixer de Sobreposição.
Para obter outras interfaces, chame IDvdGraphBuilder::GetFiltergraph. Consulte a interface IGraphBuilder retornada ou use EnumFilters para enumerar os filtros.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Aplicativos DE DVD

Códigos de erro e êxito

IDvdGraphBuilder Interface