My proposal is to add type aliasing for *mut c_void in the context of interface methods.
Example:
type IParamValueQueuePtr = *mut c_void;
#[com_interface("A4779663-0BB6-4A56-B443-84A8466FEB9D")]
pub trait IParameterChanges: IUnknown {
unsafe fn get_parameter_count(&self) -> i32;
unsafe fn get_parameter_data(&self, index: i32) -> IParamValueQueuePtr;
unsafe fn add_parameter_data(&self, id: *const u32, index: *mut i32) -> IParamValueQueuePtr;
}
The reason for this is that we necessarily need to have these methods return a *mut c_void otherwise it's impossible to cast a fat pointer (like dyn IParamValueQueue) to a thin pointer. By introducing these type aliases we keep the semantics of the method intact (so we know what type is returned by reading the alias name). An alternative can be to use docs, but I feel like this approach is more immediate and requires less noisy information.
My proposal is to add type aliasing for
*mut c_voidin the context of interface methods.Example:
The reason for this is that we necessarily need to have these methods return a
*mut c_voidotherwise it's impossible to cast a fat pointer (likedyn IParamValueQueue) to a thin pointer. By introducing these type aliases we keep the semantics of the method intact (so we know what type is returned by reading the alias name). An alternative can be to use docs, but I feel like this approach is more immediate and requires less noisy information.