Previous Next

KSPROPERTY_DIRECTSOUND3DLISTENER_ALLOCATION

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.

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:

For a get-property request, a value of TRUE or FALSE indicates whether or not 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.

Headers

Declared in ksmedia.h. Include ksmedia.h.

See Also

KSNODEPROPERTY