| OpenBeOS.MediaKit.APIChanges |
 |
|
Proposed API Changes/Extensions for the Media Kit
BMediaRoster
Getting the right node
In addition to its general node handling functions, the MediaRoster provides the following API functions for connecting specifically to "system nodes"
- GetAudioMixer() :
This returns the system audio mixer - usually the first instance of a node with the System Mixer Kinds set.
- GetAudioInput(), GetAudioOutput(), GetVideoInput(), GetVideoOutput() :
These functions return the node specified as the 'default' Audio/Video Input/Output. This is done using the corresponding Set(Audio|Video)(Input|Output) call.
The proposal is to replace these functions with API calls that are more generalised, and applicable to all types of media.
- GetMediaHub(media_type forType, media_node *outNode)
Replaces GetAudioMixer(). A MediaHub is a node who (in addition to having the Media Hub Kinds set, specifies itself as the default connection point for one or more Type(s).
So, the equivalent call to GetAudioMixer(mixerNode) is now GetMediaHub(B_MEDIA_RAW_AUDIO, mixerNode)
- GetMediaInput(media_type forType, media_node *outNode),
GetMediaOutput(media_type forType, media_node *outNode)
Replace the separate audio/video functions with the new generalised versions.
- SetMediaInput(media_type forType, const media_node &defaultNode)
SetMediaOutput(media_type forType, const media_node &defaultNode)
As above.
DavidShipman
|
|
|
