ITAllocatorProperties::SetAllocatorProperties method (tapi3.h)
The SetAllocatorProperties method must be called before connection and will force the MSP to use these values during filter negotiation. If the connecting filter doesn't accept these values, the connection is not established.
Syntax
HRESULT SetAllocatorProperties(
[in] ALLOCATOR_PROPERTIES *pAllocProperties
);
Parameters
[in] pAllocProperties
Pointer to the allocator buffer.
Return value
If the method succeeds, it returns S_OK. Otherwise, it returns an error value.
Remarks
This method should be used with extreme care. The quality of the sound may suffer if the values entered for this method are not optimal for the MSP. Therefore, the application should know exactly the properties preferred by the MSP before calling this method. Under Windows 2000, properties entered during calls to this method are ignored if they are not optimal. Under Windows XP, these values are not ignored and the application must be more knowledgeable.
If the application is only concerned with setting consistent buffer sizes, the ITAllocatorProperties::SetBufferSize method should be used instead. This guarantees the application is provided with the specified buffer size.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi3.h (include Tapi3.h) |
| Library | Uuid.lib |
| DLL | Tapi3.dll |