Collapse all Symbian^3 Product Developer Library

MRemConDatabaseAwareMediaLibraryBrowse Class Reference

class MRemConDatabaseAwareMediaLibraryBrowse

Public Member Functions
IMPORT_C void	MrcdamlbFolderDownResult(TUint, TInt)
IMPORT_C void	MrcdamlbFolderItemResult(const TRemConItemUid &, const TDesC8 &, TFolderItemType, TFolderItemPlayable, const TArray< TMediaElementAttribute > &, TInt)
IMPORT_C void	MrcdamlbFolderListing(const TArray< TRemConItem > &, TUint16, TUint)
IMPORT_C void	MrcdamlbFolderUpResult(TUint, TInt)
IMPORT_C void	MrcdamlbGetPathResult(TUint, TUint16, TInt)
IMPORT_C void	MrcdamlbMediaElementItemResult(const TRemConItemUid &, const TDesC8 &, TMediaItemType, const TArray< TMediaElementAttribute > &, TInt)
IMPORT_C void	MrcdamlbMediaLibraryStateChange(TUint16)
IMPORT_C void	MrcdamlbSearchResult(TUint, TUint16, TInt)

Private Member Functions
void	MrcdamlbDoFolderDownResult(TUint, TInt)
void	MrcdamlbDoFolderItemResult(const TRemConItemUid &, const TDesC8 &, TFolderItemType, TFolderItemPlayable, const TArray< TMediaElementAttribute > &, TInt)
void	MrcdamlbDoFolderListing(const TArray< TRemConItem > &, TUint16, TUint)
void	MrcdamlbDoFolderUpResult(TUint, TInt)
void	MrcdamlbDoGetPathResult(TUint, TUint16, TInt)
void	MrcdamlbDoMediaElementItemResult(const TRemConItemUid &, const TDesC8 &, TMediaItemType, const TArray< TMediaElementAttribute > &, TInt)
void	MrcdamlbDoMediaLibraryStateChange(TUint16)
void	MrcdamlbDoSearchResult(TUint, TUint16, TInt)

Member Functions Documentation

MrcdamlbDoFolderDownResult(TUint, TInt)

void	MrcdamlbDoFolderDownResult	(	TUint	aItemCount,
			TInt	aResult
		)	[private, pure virtual]

Parameters

TUint aItemCount
TInt aResult

MrcdamlbDoFolderItemResult(const TRemConItemUid &, const TDesC8 &, TFolderItemType, TFolderItemPlayable, const TArray< TMediaElementAttribute > &, TInt)

void	MrcdamlbDoFolderItemResult	(	const TRemConItemUid &	aFolderID,
			const TDesC8 &	aFolderName,
			TFolderItemType	aFolderType,
			TFolderItemPlayable	aPlayable,
			const TArray< TMediaElementAttribute > &	aAttributes,
			TInt	aResult
		)	[private, pure virtual]

Parameters

const TRemConItemUid & aFolderID
const TDesC8 & aFolderName
TFolderItemType aFolderType
TFolderItemPlayable aPlayable
const TArray< TMediaElementAttribute > & aAttributes
TInt aResult

MrcdamlbDoFolderListing(const TArray< TRemConItem > &, TUint16, TUint)

void	MrcdamlbDoFolderListing	(	const TArray< TRemConItem > &	aFolderListing,
			TUint16	aMediaLibraryStateCookie,
			TUint	aResult
		)	[private, pure virtual]

Parameters

const TArray< TRemConItem > & aFolderListing
TUint16 aMediaLibraryStateCookie
TUint aResult

MrcdamlbDoFolderUpResult(TUint, TInt)

void	MrcdamlbDoFolderUpResult	(	TUint	aItemCount,
			TInt	aResult
		)	[private, pure virtual]

Parameters

TUint aItemCount
TInt aResult

MrcdamlbDoGetPathResult(TUint, TUint16, TInt)

void	MrcdamlbDoGetPathResult	(	TUint	aItemCount,
			TUint16	aMediaLibraryStateCookie,
			TInt	aResult
		)	[private, pure virtual]

Parameters

TUint aItemCount
TUint16 aMediaLibraryStateCookie
TInt aResult

MrcdamlbDoMediaElementItemResult(const TRemConItemUid &, const TDesC8 &, TMediaItemType, const TArray< TMediaElementAttribute > &, TInt)

void	MrcdamlbDoMediaElementItemResult	(	const TRemConItemUid &	aMediaID,
			const TDesC8 &	aMediaName,
			TMediaItemType	aMediaType,
			const TArray< TMediaElementAttribute > &	aAttributes,
			TInt	aResult
		)	[private, pure virtual]

Parameters

const TRemConItemUid & aMediaID
const TDesC8 & aMediaName
TMediaItemType aMediaType
const TArray< TMediaElementAttribute > & aAttributes
TInt aResult

MrcdamlbDoMediaLibraryStateChange(TUint16)

void

MrcdamlbDoMediaLibraryStateChange

(

TUint16

aMediaLibraryStateCookie

)

[private, pure virtual]

Parameters

TUint16 aMediaLibraryStateCookie

MrcdamlbDoSearchResult(TUint, TUint16, TInt)

void	MrcdamlbDoSearchResult	(	TUint	aNumberItemsFound,
			TUint16	aMediaLibraryStateCookie,
			TInt	aResult
		)	[private, pure virtual]

Parameters

TUint aNumberItemsFound
TUint16 aMediaLibraryStateCookie
TInt aResult

MrcdamlbFolderDownResult(TUint, TInt)

IMPORT_C void	MrcdamlbFolderDownResult	(	TUint	aItemCount,
			TInt	aResult
		)

Called by the client in response to a MrcdamlboFolderDown() call.

Parameters

TUint aItemCount

The number of items present in this folder.

TInt aResult

The result of the MrcdamlboFolderDown() operationKErrNone if the operation was successful.KErrInvalidMediaLibraryStateCookie if the media library state cookie provided does not match the client's state cookieKErrMediaBrowseInvalidDirection if the folder provided is not a valid folder e.g. path A/B/C, the current dirctory is B, and the param provided with MrcdamlboFolderDown()is A, obviously you can not change folder down to A, so A is invalid.KErrMediaBrowseNotADirectory if the UID provided does not refer to a folder item, e.g. it is a media element.KErrInvalidUid if the UID provided is invalid.System wide error code otherwise.

MrcdamlbFolderItemResult(const TRemConItemUid &, const TDesC8 &, TFolderItemType, TFolderItemPlayable, const TArray< TMediaElementAttribute > &, TInt)

IMPORT_C void	MrcdamlbFolderItemResult	(	const TRemConItemUid &	aFolderID,
			const TDesC8 &	aFolderName,
			TFolderItemType	aFolderType,
			TFolderItemPlayable	aPlayable,
			const TArray< TMediaElementAttribute > &	aAttributes,
			TInt	aResult
		)

Called by the client in response to MrcdamlboGetItem() call in the case the requested item is a folder item.

Parameters

const TRemConItemUid & aFolderID	The folder UID.
const TDesC8 & aFolderName	The folder name. Takes a copy of it.
TFolderItemType aFolderType	The folder type.
TFolderItemPlayable aPlayable	Indicaties whether the folder is playableKFolderNotPlayable the folder can not be playedKFolderPlayable the folder can be played
const TArray< TMediaElementAttribute > & aAttributes	The attributes of the folder item requested by MrcdamlboGetItem()
TInt aResult	The result of the MrcdamlboGetItem() operation.KErrNone if the operation was successful.KErrInvalidMediaLibraryStateCookie if the media library state cookie provided does not match the client's state cookie.KErrInvalidUid if the uid of the item requested is invalid, e.g. the client removed the item before the request MrcdamlboGetItem() coming.System wide error code otherwise.

MrcdamlbFolderListing(const TArray< TRemConItem > &, TUint16, TUint)

IMPORT_C void	MrcdamlbFolderListing	(	const TArray< TRemConItem > &	aFolderListing,
			TUint16	aMediaLibraryStateCookie,
			TUint	aResult
		)

Called by the client in response to a MrcdamlboGetFolderListing() call.

Parameters

const TArray< TRemConItem > & aFolderListing	A listing of the items that are in the range requested by the MrcdamlboGetFolderListing() call.
TUint16 aMediaLibraryStateCookie	The current value of the state cookie.
TUint aResult	The result of the MrcdamlboGetFolderListing() operation.KErrNone if the operation was successful.KErrMediaBrowseInvalidOffset if there is no media available at the offset of the start item, i.e. the start of range provided via MrcdamlboGetFolderListing() is not valid.System wide error code otherwise.

MrcdamlbFolderUpResult(TUint, TInt)

IMPORT_C void	MrcdamlbFolderUpResult	(	TUint	aItemCount,
			TInt	aResult
		)

Called by the client in response to a MrcdamlboFolderUp call.

Parameters

TUint aItemCount	The number of items present in this folder.
TInt aResult	The result of the MrcdamlboFolderUp operation.KErrNone if the operation was successful.KErrInvalidMediaLibraryStateCookie if the media library state cookie provided does not match the client's state cookieSystem wide error code otherwise.

MrcdamlbGetPathResult(TUint, TUint16, TInt)

IMPORT_C void	MrcdamlbGetPathResult	(	TUint	aItemCount,
			TUint16	aMediaLibraryStateCookie,
			TInt	aResult
		)

Called by the client in response to a MrcdamlboGetPath() call.

Parameters

TUint aItemCount	The number of items present in this folder.
TUint16 aMediaLibraryStateCookie	The current value of the state cookie.
TInt aResult	The result of the MrcdamlboGetPath() operationKErrNone if the operation is successful.System wide error code otherwise.

MrcdamlbMediaElementItemResult(const TRemConItemUid &, const TDesC8 &, TMediaItemType, const TArray< TMediaElementAttribute > &, TInt)

IMPORT_C void	MrcdamlbMediaElementItemResult	(	const TRemConItemUid &	aMediaID,
			const TDesC8 &	aMediaName,
			TMediaItemType	aMediaType,
			const TArray< TMediaElementAttribute > &	aAttributes,
			TInt	aResult
		)

Called by the client in response to MrcdamlboGetItem() call in the case the requested item is a media element item.

Parameters

const TRemConItemUid & aMediaID	The media element UID.
const TDesC8 & aMediaName	The media name. Takes a copy of it.
TMediaItemType aMediaType	The media type.
const TArray< TMediaElementAttribute > & aAttributes	The attributes list. Takes a copy of it.
TInt aResult	The result of the MrcdamlboGetItem() operation.KErrNone if the operation was successful.KErrInvalidMediaLibraryStateCookie if the media library state cookie provided does not match the client's state cookie.KErrInvalidUid if the uid of the item requested is invalid, e.g. the client removed the item before the request MrcdamlboGetItem() coming.System wide error code otherwise.

MrcdamlbMediaLibraryStateChange(TUint16)

IMPORT_C void

MrcdamlbMediaLibraryStateChange

(

TUint16

aMediaLibraryStateCookie

)

Called by the client in the case that the state of the media library has changed. This means that the media library state cookie provided prior to this call by the client may no longer be valid. Typical causes for this would be items added or removed from the media library.

This function shall be called by any client any time it believes that media library state cookie has ceased to be valid, for example if the current directory is on removable media, and that media has been removed. That includes clients that are only able to offer state cookie that are limited to one directory.

Parameters

TUint16 aMediaLibraryStateCookie

The current value of the state cookie which enables state mismatches between the client and the remote controller device to be detected.

MrcdamlbSearchResult(TUint, TUint16, TInt)

IMPORT_C void	MrcdamlbSearchResult	(	TUint	aNumberItemsFound,
			TUint16	aMediaLibraryStateCookie,
			TInt	aResult
		)

Called by the client in response to a MrcdamlboSearch() call to indicate that a search has completed.

Parameters

TUint aNumberItemsFound	The number of items found by the search.
TUint16 aMediaLibraryStateCookie	The current of the state cookie.
TInt aResult	The result of the search.KErrNone if the search completed successfullySystem wide error otherwise.