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

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 RenderDvdVideoVolume método conclui a criação de um grafo de filtro de acordo com as especificações do usuário para reproduzir um volume DVD-Video.

Sintaxe

HRESULT RenderDvdVideoVolume(
  [in]  LPCWSTR             lpcwszPathName,
  [in]  DWORD               dwFlags,
  [out] AM_DVD_RENDERSTATUS *pStatus
);

Parâmetros

[in] lpcwszPathName

Ponteiro para o caminho do volume de DVD-Video a ser reproduzido. Pode ser NULL.

[in] dwFlags

OR bit a bit de sinalizadores de AM_DVD_GRAPH_FLAGS enumeração, especificando como criar o grafo de reprodução de DVD.

[out] pStatus

Ponteiro para uma estrutura AM_DVD_RENDERSTATUS . Quando o método retorna, a estrutura indica quaisquer falhas de renderização.

Retornar valor

Retorna um valor HRESULT que depende da implementação da interface . Os valores retornados da implementação do DirectShow incluem o seguinte:

Código de retorno Descrição
E_INVALIDARG
O parâmetro dwFlags especifica opções conflitantes.
S_FALSE
O método foi parcialmente bem-sucedido. Para descobrir quais erros ocorreram, examine o parâmetro pStatus .
S_OK
O método foi bem-sucedido e todos os fluxos foram renderizados.
VFW_E_DVD_DECNOTENOUGH
Não foi possível renderizar um ou mais fluxos.

Se você especificou o sinalizador AM_DVD_HWDEC_ONLY ou AM_DVD_SWDEC_ONLY no parâmetro dwFlags , tente chamar o método novamente com o sinalizador AM_DVD_HWDEC_PREFER ou AM_DVD_SWDEC_PREFER.

VFW_E_DVD_NON_EVR_RENDERER_IN_FILTER_GRAPH
O grafo de filtro já contém um renderizador de vídeo. O método retornará esse código de erro se você especificar o sinalizador AM_DVD_EVR_ONLY no parâmetro dwFlags , mas o grafo já contiver um renderizador de vídeo diferente do filtro VMR (Renderizador de Vídeo Avançado).
VFW_E_DVD_RENDERFAIL
Ocorreu um erro ao compilar o grafo. Por exemplo, o Dvd Graph Builder não pôde criar um filtro necessário ou não pôde renderizar nenhum dos fluxos.
VFW_E_DVD_TOO_MANY_RENDERERS_IN_FILTER_GRAPH
O grafo de filtro contém mais de um renderizador de vídeo.

Comentários

A estrutura AM_DVD_RENDERSTATUS reflete códigos de falha para esse método. Os motivos para esse método retornar S_FALSE incluem o seguinte:

  • O grafo foi completamente compilado, mas um dos itens a seguir é verdadeiro.
    • A combinação de sobreposição não funciona— o aplicativo não definiu o sinalizador AM_DVD_NOVPE e o fluxo de vídeo não pôde ser colocado por meio do Mixer de Sobreposição. Nesse caso, se o vídeo for decodificado no software, o aplicativo terá informações suficientes para informar ao usuário que o vídeo não ficará visível. O vídeo decodificado por hardware ficará visível apenas em uma TV conectada à porta de saída do NTSC do decodificador de vídeo de hardware.
    • O decodificador de vídeo não produz dados de linha 21. O aplicativo pode exibir um aviso ou uma mensagem informativa informando que a legendagem oculta não está disponível devido ao decodificador.
    • Nenhum caminho de volume é especificado e o Navegador de DVD não localizou nenhum volume DVD-Video a ser reproduzido. O aplicativo pode solicitar que o usuário insira um disco DVD-Video se nenhum estiver disponível na unidade quando a reprodução for iniciada.
  • Alguns fluxos não foram renderizados. O aplicativo pode indicar ao usuário que alguns fluxos não podem ser reproduzidos.
Esse método cria o grafo sem nenhum conhecimento do arquivo DVD-Video ou volume a ser reproduzido. O construtor de grafo DVD-Video compila o grafo mesmo que lpcwszPathName seja NULL ou se o filtro navegador de DVD não encontrar um volume de DVD-Video padrão a ser reproduzido.

Requisitos

Requisito Valor
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