Skip to content

Proposal for increasing interface readability #23

@MirkoCovizzi

Description

@MirkoCovizzi

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.

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions