Compartilhar via


Método IDvdControl2::SelectKaraokeAudioPresentationMode (strmif.h)

[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 SelectKaraokeAudioPresentationMode método envia canais auxiliares de karaokê para os alto-falantes à esquerda ou à direita.

Sintaxe

HRESULT SelectKaraokeAudioPresentationMode(
  [in] ULONG ulMode
);

Parâmetros

[in] ulMode

OR bit a bit de DVD_KARAOKE_DOWNMIX enumeração que indica como reduzir os cinco canais de karaokê para os canais 0 e 1, que geralmente são gerados para os alto-falantes esquerdo e direito.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
Êxito.
E_PROP_SET_UNSUPPORTED
O decodificador de áudio não dá suporte a downmixing.
VFW_E_DVD_INVALIDDOMAIN
O filtro DVD Navigator está em um domínio inválido.
VFW_E_DVD_OPERATION_INHIBITED
O controle UOP proíbe a operação atual.

Comentários

Quando o DVD Navigator entra no modo de karaokê, ele consulta o decodificador de áudio para descobrir se ele dá suporte ao downmixing de karaokê. Se o decodificador der suporte a ele, os canais 2 a 4 (os canais auxiliares de karaokê com os vocais de guia, as melodias de guia e os efeitos sonoros) serão silenciados. Use esse método para ativar ou desativar canais individuais e direcioná-los para os canais 0 e 1.

Esse método é demonstrado no aplicativo DVDSample em CKaraokeDlg::D oModal.

A tabela a seguir mostra o nome do comando Anexo J ao qual esse nome de método corresponde e os domínios nos quais esse método é válido.

Nome do Comando Do Anexo J Domínios válidos
Karaoke_Audio_Presentation_Mode_Change
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu
  • DVD_DOMAIN_Title
  • DVD_DOMAIN_Stop

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [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

Conjunto de propriedades do DVD Karaoke

Códigos de erro e êxito

IDvdControl2 Interface