Compartir a través de

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

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetKaraokeAttributes método recupera los atributos de karaoke de la secuencia de audio especificada en el título o menú actual.

Sintaxis

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

Parámetros

[in] ulStream

Especifica el índice de la secuencia de audio cuyos atributos desea consultar. Vea la sección Comentarios.

[out] pAttributes

Puntero a una estructura de DVD_KaraokeAttributes que se rellena con los atributos de karaoke.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto Descripción
S_OK
 Correcto.
E_POINTER
 Argumento no válido.
E_UNEXPECTED
 El navegador de DVD no se inicializa.
VFW_E_DVD_NOT_IN_KARAOKE_MODE
 La secuencia especificada no está en formato karaoke.
VFW_E_DVD_INVALIDDOMAIN
 El navegador de DVD no está en el dominio de título.
VFW_E_DVD_NO_ATTRIBUTES
 Los atributos de karaoke para la secuencia especificada no están disponibles.

Comentarios

Este método no devuelve explícitamente el número de canales de la secuencia. Puede obtener esa información a través de una llamada a IDvdInfo2::GetAudioAttributes. Este método se muestra en la aplicación DVDSample en CKaraokeDlg::D oModal.

El parámetro ulStream puede ser un valor comprendido entre 0 y 7 o uno de los siguientes:

Valor Descripción
DVD_STREAM_DATA_CURRENT (0x800) Para consultar la secuencia de audio seleccionada actualmente.
DVD_DEFAULT_AUDIO_STREAM Para consultar la secuencia de audio predeterminada.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado strmif.h (incluye Dshow.h)
Library Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdInfo2 (Interfaz)