Share via

Método IDvdInfo2::GetKaraokeAttributes (strmif.h)

  • Artigo

[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 GetKaraokeAttributes método recupera os atributos de karaokê do fluxo de áudio especificado no título ou menu atual.

Sintaxe

HRESULT GetKaraokeAttributes(
  [in]  ULONG                 ulStream,
  [out] DVD_KaraokeAttributes *pAttributes
);

Parâmetros

[in] ulStream

Especifica o índice do fluxo de áudio cujos atributos você deseja consultar. Consulte Observações.

[out] pAttributes

Ponteiro para uma estrutura DVD_KaraokeAttributes preenchida com os atributos de karaokê.

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno Descrição
S_OK
 Êxito.
E_POINTER
 Argumento inválido.
E_UNEXPECTED
 O Navegador de DVD não foi inicializado.
VFW_E_DVD_NOT_IN_KARAOKE_MODE
 O fluxo especificado não está no formato karaokê.
VFW_E_DVD_INVALIDDOMAIN
 O Navegador de DVD não está no domínio do título.
VFW_E_DVD_NO_ATTRIBUTES
 Os atributos de karaokê para o fluxo especificado não estão disponíveis.

Comentários

Esse método não retorna explicitamente o número de canais no fluxo. Você pode obter essas informações por meio de uma chamada para IDvdInfo2::GetAudioAttributes. Esse método é demonstrado no aplicativo DVDSample em CKaraokeDlg::D oModal.

O parâmetro ulStream pode ser um valor de 0 a 7 ou um dos seguintes:

Valor Descrição
DVD_STREAM_DATA_CURRENT (0x800) Para consultar o fluxo de áudio selecionado no momento.
DVD_DEFAULT_AUDIO_STREAM Para consultar o fluxo de áudio padrão.

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

Códigos de erro e êxito

IDvdInfo2 Interface