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.
Usage Summary Table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
Yes |
Yes |
Pin |
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) |