通过

IDvdInfo2：：GetKaraokeAttributes 方法 (strmif.h)

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 GetKaraokeAttributes 检索当前标题或菜单中指定音频流的卡拉OK 属性。

语法

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

参数

[in] ulStream

指定要查询其属性的音频流的索引。 请参阅“备注”。

[out] pAttributes

指向用卡拉OK 属性填充的 DVD_KaraokeAttributes 结构的指针。

返回值

返回以下 HRESULT 值之一。

返回代码 说明
S_OK
 成功。
E_POINTER
 无效的参数。
E_UNEXPECTED
 DVD 导航器未初始化。
VFW_E_DVD_NOT_IN_KARAOKE_MODE
 指定的流不是卡拉OK格式。
VFW_E_DVD_INVALIDDOMAIN
 DVD 导航器不在游戏域中。
VFW_E_DVD_NO_ATTRIBUTES
 指定流的卡拉OK 属性不可用。

注解

此方法不显式返回流中的通道数。 可以通过调用 IDvdInfo2：：GetAudioAttributes 获取该信息。 此方法在 CKaraokeDlg：:D oModal 中的 DVDSample 应用程序中演示。

ulStream 参数可以是 0 到 7 的值，也可以是下列值之一：

值 说明
DVD_STREAM_DATA_CURRENT (0x800) 查询当前选定的音频流。
DVD_DEFAULT_AUDIO_STREAM 查询默认音频流。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

DVD 应用程序

错误和成功代码

IDvdInfo2 接口