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.
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.
Declared in ksmedia.h. Include ksmedia.h.