SHI_Service Class

A media service APIs module. More...

Typedefs
typedef struct SHI_Service	SHI_Service
	A SHI_Service object represents information about a service. More...

Functions
SHI_PUBLIC_API void *	SHI_Service_GetInterface (SHI_Service *self, SHI_InterfaceId iface_id)
	Obtains a pointer to a SHI_Service object with a different interface. More...
SHI_PUBLIC_API SHI_Result	SHI_Service_Release (SHI_Service *self)
	Releases this service object. More...
SHI_PUBLIC_API SHI_Result	SHI_Service_GetInfo (SHI_Service *self, SHI_ServiceInfo *info)
	Gets basic information about this service. More...
SHI_PUBLIC_API SHI_Result	SHI_Service_GetDetails (SHI_Service *self, SHI_Attribute **details)
	Gets the details of this service. More...

Detailed Description

A media service APIs module.

Typedef Documentation

SHI_Service

typedef struct SHI_Service SHI_Service

A SHI_Service object represents information about a service.

Function Documentation

SHI_Service_GetDetails()

SHI_PUBLIC_API SHI_Result SHI_Service_GetDetails	(	SHI_Service *	self,
		SHI_Attribute **	details
	)

Gets the details of this service.

These details are returned as a tree of SHI_Attribute objects that represent detailed information about the service. If no details are available for this service, this method returns SHI_ERROR_NOT_AVAILABLE.

Parameters

self	The SHI_Service whose details will be returned.
details	Address of a SHI_Attribute pointer that will be set to refer to a SHI_Attribute object containing the details.

SHI_Service_GetInfo()

SHI_PUBLIC_API SHI_Result SHI_Service_GetInfo	(	SHI_Service *	self,
		SHI_ServiceInfo *	info
	)

Gets basic information about this service.

Parameters

self	The SHI_Service for which the information is obtained.
info	A pointer to a SHI_ServiceInfo structure in which the information will be returned.

SHI_Service_GetInterface()

SHI_PUBLIC_API void* SHI_Service_GetInterface	(	SHI_Service *	self,
		SHI_InterfaceId	iface_id
	)

Obtains a pointer to a SHI_Service object with a different interface.

This method returns NULL if the object does not implement the requested interface.

Parameters

self	The SHI_Service whose interface will be returned.
iface_id	The ID of the interface that is requested.

Returns

A pointer to the requested interface, or NULL if the object does not implement it.

SHI_Service_Release()

SHI_PUBLIC_API SHI_Result SHI_Service_Release

(

SHI_Service *

self

)

Releases this service object.

The object can no longer be used after this method returns. All objects obtained from method calls to this object must be released before this object is released.

Parameters

self	The SHI_Service to release.