KSPROPERTY_DIRECTSOUND3DLISTENER_BATCH

KSPROPERTY_DIRECTSOUND3DLISTENER_BATCH 属性指定 3D 侦听器的批处理模式设置。

使用情况摘要表

获取 设置 目标 属性描述符类型 属性值类型

固定

KSNODEPROPERTY

BOOL

属性值(操作数据)的类型为 BOOL,并指定批处理模式设置:

  • 当此属性的值为 TRUE 时,微型端口驱动程序会缓存侦听器属性和所有关联的缓冲区属性的所有更改。

  • 如果值为 FALSE,则对侦听器属性和缓冲区属性的更改将立即生效。

返回值

KSPROPERTY_DIRECTSOUND3DLISTENER_BATCH 属性请求返回 STATUS_SUCCESS,以指示已成功完成。 否则,请求将返回适当的错误状态代码。

注解

当此属性从 TRUE 转换为 FALSE 时,微型端口驱动程序会立即使所有缓存的属性生效。 如果可能,应同时生效任何缓存的属性。

有关 3D 侦听器的批处理模式设置的详细信息,请参阅 Microsoft Windows SDK 文档中 IDirectSound3DListener::CommitDeferredSettings 方法的说明。

要求

标头

Ksmedia.h(包括 Ksmedia.h)

另请参阅

KSNODEPROPERTY