Método IDvdInfo2::GetKaraokeAttributes (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 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 |
|---|---|
|
Êxito. |
|
Argumento inválido. |
|
O Navegador de DVD não foi inicializado. |
|
O fluxo especificado não está no formato karaokê. |
|
O Navegador de DVD não está no domínio do título. |
|
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 |