Edit

KSPROPERTY_DIRECTSOUND3DLISTENER_ALLOCATION

  • Article

The KSPROPERTY_DIRECTSOUND3DLISTENER_ALLOCATION property is used to tell the driver when to allocate and free the storage for its listener data. Storage is allocated when the listener is created, and freed when the listener is deleted. This property can also be used to query the driver whether listener data is currently allocated.

Usage Summary Table

Get Set Target Property descriptor type Property value type

Yes

Yes

Pin

KSNODEPROPERTY

BOOL

The property value (operation data) is of type BOOL. For a set-property request, this value specifies whether the driver should allocate or free the storage for its listener data:

  • A value of TRUE directs the driver to allocate storage for its listener data.

  • A value of FALSE tells the driver to free the listener data.

For a get-property request, a value of TRUE or FALSE indicates whether the driver currently holds a storage allocation for listener data.

Return Value

A KSPROPERTY_DIRECTSOUND3DLISTENER_ALLOCATION property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.

Requirements

Header

 Ksmedia.h (include Ksmedia.h)

See also

KSNODEPROPERTY