/////////////////////////////////////////////////////////////////////////////////////
//
// File: nmsdk.h
//
// Purpose: Combination of the Jukebox SDK2 header file and the NomadII SDK2 header file.
//
// Notes: Please make sure to include the COM Stuffs <Objbase.h> and <initguid.h>
// at the beginning of the application programs. Otherwise, it will get Link Errors.
//
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
// PARTICULAR PURPOSE.
//
// Copyright (c) Creative Technology Ltd., 2001. All rights reserved.
//
/////////////////////////////////////////////////////////////////////////////////////
/////////////////////////////////////////////////////////////////////////////
// nmsdk.h : main header file for export
// Version: 1.0.7.0
/////////////////////////////////////////////////////////////////////////////
#ifndef __nmsdk_h__
#define __nmsdk_h__
//
// COM Interface Declaration
//
#ifdef __cplusplus
extern "C" {
#endif // __cplusplus
//////////////////////////////////////////////////////////////////////////
// Class ID //
//////////////////////////////////////////////////////////////////////////
//CLSID CLSID_CTJukeBox2:
// {BD1A6357-3E9B-4f1b-8375-AEE989ED6C5E}
DEFINE_GUID(CLSID_CTJukeBox2,
0xbd1a6357, 0x3e9b, 0x4f1b, 0x83, 0x75, 0xae, 0xe9, 0x89, 0xed, 0x6c, 0x5e);
//CLSID CLSID_CTNOMAD2:
// {0EBE3156-FD3A-4f5c-ABDB-71E3BEEAD091}
DEFINE_GUID(CLSID_CTNOMAD2,
0xebe3156, 0xfd3a, 0x4f5c, 0xab, 0xdb, 0x71, 0xe3, 0xbe, 0xea, 0xd0, 0x91);
//////////////////////////////////////////////////////////////////////////
// return codes //
//////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////
// JukeBox & NomadII shared stuffs //
//////////////////////////////////////////////////////
// Additional Error codes
#define DAPSDK_SUCCESS 0x00
// General Error
#define DAPSDK_FAILED 0x01
#define DAPSDK_E_DEVICE_BUSY 0x02
#define DAPSDK_E_STORAGE_FULL 0x03
#define DAPSDK_E_SETTIME_REJECTED 0x05
#define DAPSDK_E_ITEM_SIZE_MISSING 0x14 //NMJB_E_TRACK_SIZE_MISSING
#define DAPSDK_E_ITEM_UPLOAD_DENIED 0x18 //NMJB_E_TRACK_UPLOAD_DENIED
#define DAPSDK_E_PLAYER_NOT_CONNECTED 0x80
#define DAPSDK_E_CANCELLED 0x81
#define DAPSDK_E_PORT_UNAVAILABLE 0x82
#define DAPSDK_E_OUT_OF_MEMORY 0x83
#define DAPSDK_E_FILEOPEN_ERR 0x84
#define DAPSDK_E_ITEM_NOT_FOUND 0x85
#define DAPSDK_E_LOAD_COMPONENTS_FAILED 0x86
#define DAPSDK_E_ID_INVALID 0x87
#define DAPSDK_E_FILETYPE_ILLEGAL 0x88
#define DAPSDK_E_LOADRES_FAIL 0x89
#define DAPSDK_E_FORMAT_NOT_FOUND 0x8a
#define DAPSDK_E_FILE_ALREADY_EXISTS 0x8b
#define DAPSDK_E_LIB_CORRUPTED 0x8c
#define DAPSDK_E_LIB_BUSY 0x8d
#define DAPSDK_E_FILE_READ_WRITE_FAILED 0x8e //NMJB_E_FILE_WRITE_FAILED
#define DAPSDK_E_INVALID_FILEPATH 0x8f
#define DAPSDK_E_UNSUPPORTED 0x91
#define DAPSDK_E_NORIGHTS 0x95
#define DAPSDK_E_UNDEFINED_ERR 0xff
//////////////////////////////////////////////////////
// NomadII stuffs //
//////////////////////////////////////////////////////
#define DAPSDK_E_SMARTMEDIA_WRITE_PROTECTED 0x98
#define DAPSDK_E_NO_STORAGE 0x99 //No internal media or smart media
//////////////////////////////////////////////////////
// JukeBox stuffs //
//////////////////////////////////////////////////////
// General Error
#define DAPSDK_E_HD_GENERAL_ERROR 0x04
// Track Management Error
#define DAPSDK_E_TRACK_NOT_FOUND 0x10
#define DAPSDK_E_TRACK_ALREADY_EXIST 0x11
#define DAPSDK_E_TRACK_TITLE_MISSING 0x12
#define DAPSDK_E_TRACK_CODEC_MISSING 0x13
#define DAPSDK_E_TRACK_IO_OPERATION_ABORTED 0x15
#define DAPSDK_E_TRACK_READ_WRITE_ERROR 0x16
#define DAPSDK_E_TRACK_NOT_OPENED 0x17
// Playlist Error
#define DAPSDK_E_PL_NOT_FOUND 0x20
#define DAPSDK_E_PL_ALREADY_EXIST 0x21
#define DAPSDK_E_PL_ITEM_NOT_FOUND 0x22
#define DAPSDK_E_PL_ITEM_ALREADY_EXIST 0x23
//Additional
#define DAPSDK_E_DISKFULL_FOR_DOWNLOAD 0x90
#define DAPSDK_E_STATUS_TIMEOUT 0x06
// Transport Control Error
#define DAPSDK_E_END_OF_TRACK 0x30
#define DAPSDK_E_END_OF_LIST 0x31
#define DAPSDK_E_CODEC_NOT_SUPPORTED 0x32
#define DAPSDK_E_DATA_CORRUPTED 0x33
#define DAPSDK_E_SAMPLING_RATE_NOT_SUPPORTED 0x34
#define DAPSDK_E_DECODING_ERROR 0x35
#define DAPSDK_E_POSITION_OUTOF_RANGE 0x36
#define DAPSDK_E_NOT_STOPPED 0x37
// Audio Control Error
#define DAPSDK_E_UNKNOW_PROPERTY 0x40
#define DAPSDK_E_VALUE_OUTOF_RANGE 0x41
// USB Transaction Error
#define DAPSDK_E_DATA_FILE_NOT_FOUND 0x60
#define DAPSDK_E_DATA_FILE_TOO_BIG 0x61
#define DAPSDK_E_DATA_FILE_ALREADY_EXIST 0x62
#define DAPSDK_E_TOO_MANY_DATA_FILES 0x63
//additional
#define DAPSDK_E_WMDM_INIT_FAILED 0x92
#define DAPSDK_E_INVALID_ARGUMENT 0x93
#define DAPSDK_E_PARENTNODE_NOT_EXIST 0x94
#define DAPSDK_E_NORIGHTS 0x95
#define DAPSDK_E_PATH_EXCESS_LEN 0x96
#define DAPSDK_E_LOAD_PROC_FAILED 0x97
// New Error code for MultiApplication assess of Nomad Jukebox 2/3/Zen
#define DAPSDK_E_PMSMAN_CREATEDIRECTORY_FAILED 0x0100
#define DAPSDK_E_DEVICE_WRITE_FAILED 0x0200
#define DAPSDK_E_DEVICE_READ_FAILED 0x0300
#define DAPSDK_E_DB_INVALID_REQUEST_ID 0x0400
#define DAPSDK_E_DB_INVALID_NODE_ID 0x0500
#define DAPSDK_E_DWNTHRD_CREATEMETADATA_FAILED 0x0600
#define DAPSDK_E_DEVINFO_INVALID_INDEX 0x0700
#define DAPSDK_E_INVALID_DEVICESETTINGTYPE 0x0800
#define DAPSDK_E_FILESIZE_TOO_BIG 0x0900
#define DAPSDK_E_AUDIOFILE_FORMAT 0x0A00
#define DAPSDK_E_AUDIOFILE_INVALID 0x0B00
#define DAPSDK_E_ACCESS_DENIED 0x0C00
#define DAPSDK_E_FILE_NOT_FOUND 0x0D00
#define DAPSDK_E_EOF 0x0E00
#define DAPSDK_E_COOKIE 0x0F00
#define DAPSDK_E_PLAYBACK_INPROGRESS 0x1000
#define DAPSDK_E_TRANSFER_INPROGRESS 0x1100
#define DAPSDK_E_BUFFER_NOT_ENOUGH 0x1200
// New Error code for Data Folder of Nomad Jukebox 2/3/Zen
#define DAPSDK_E_NOT_A_FOLDER 0x1400 // the target file is not a folder
#define DAPSDK_E_FOLDER_NOT_EMPTY 0x1600 // the target folder is not empty
#define DAPSDK_E_FOLDER_EXIST 0x1700 // the target folder exist
#define DAPSDK_E_FOLDER_NOTEXIST 0x1800 // the target folder does not exist
#define DAPSDK_E_PARENTFOLDER_NOTEXIST 0x1900 // the target parent folder does not exist
#define DAPSDK_E_FILEPATH_TOOLONG 0x1A00 // the target file path is too long
#define DAPSDK_E_FILENAME_TOOLONG 0x1B00 // the target file name is too long
#define DAPSDK_E_INVALID_OPERATION 0x1E00 // the operation cannot be perform
//////////////////////////////////////////////////////////////////////////
// Definitions for WM Messages //
//////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////
// JukeBox & NomadII shared stuffs //
//////////////////////////////////////////////////////
// Download message
#define WM_DAPSDK_DOWNLOAD_PROGRESS WM_USER+500
#define WM_DAPSDK_DOWNLOAD_COMPLETE WM_USER+501
// Upload message
#define WM_DAPSDK_GETITEM_PROGRESS WM_USER+502
#define WM_DAPSDK_GETITEM_COMPLETE WM_USER+503
//////////////////////////////////////////////////////
// JukeBox stuffs //
//////////////////////////////////////////////////////
// Device change message
#define WM_DAPSDK_JUKEBOX_REMOVAL WM_USER+508
#define WM_DAPSDK_JUKEBOX_ARRIVAL WM_USER+509
// Playback message
#define WM_DAPSDK_PLAYBACK_COMPLETE WM_USER+504
#define WM_DAPSDK_PLAYLIST_COMPLETE WM_USER+505
#define WM_DAPSDK_PLAYBACK_ERROR WM_USER+506
#define WM_DAPSDK_PLAYBACK_PROGRESS WM_USER+507
// New callback messages for MultiApplication assess of Hotcake
// Notification Messages for database change
#define WM_DAPSDK_CHANGE_BASE WM_USER + 200
#define WM_DAPSDK_MUSIC_ADD_FILE WM_DAPSDK_CHANGE_BASE + 0 // wParam = NodeId added, lParam = nil
#define WM_DAPSDK_MUSIC_DEL_FILE WM_DAPSDK_CHANGE_BASE + 1 // wParam = NodeId deleted, lParam = nil
#define WM_DAPSDK_MUSIC_SETATTR_FILE WM_DAPSDK_CHANGE_BASE + 2 // wParam = NodeId edited, lParam = nil
#define WM_DAPSDK_DATA_ADD_FILE WM_DAPSDK_CHANGE_BASE + 3 // wParam = NodeId added, lParam = nil
#define WM_DAPSDK_DATA_DEL_FILE WM_DAPSDK_CHANGE_BASE + 4 // wParam = NodeId deleted, lParam = nil
#define WM_DAPSDK_DATA_SETATTR_FILE WM_DAPSDK_CHANGE_BASE + 5 // wParam = NodeId edited, lParam = nil
#define WM_DAPSDK_PLAYLIST_ADD_FILE WM_DAPSDK_CHANGE_BASE + 6 // wParam = NodeId added, lParam = nil
#define WM_DAPSDK_PLAYLIST_DEL_FILE WM_DAPSDK_CHANGE_BASE + 7 // wParam = NodeId deleted, lParam = nil
#define WM_DAPSDK_PLAYLIST_SETATTR_FILE WM_DAPSDK_CHANGE_BASE + 8 // wParam = NodeId edited, lParam = nil
#define WM_DAPSDK_PLAYLIST_ITEM_CHANGE WM_DAPSDK_CHANGE_BASE + 9 // wParam = PlaylistNodeId affected, lParam = nil
#define WM_DAPSDK_STORAGEINFO_CHANGE WM_DAPSDK_CHANGE_BASE + 10 // wParam = deviceIndex that change occurred, lParam = nil
#define WM_DAPSDK_ADDITEM_PROGRESS WM_USER+500
#define WM_DAPSDK_ADDITEM_COMPLETE WM_USER+501
/////////////////////////////////////////////////////////////////////////
// struct defines //
//////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////
// JukeBox & NomadII shared stuffs //
//////////////////////////////////////////////////////
typedef struct _DAPSDK_DATE_TIME
{
short Year, Month, Day, DayOfWeek;
short Hour, Min, Sec, MilliSec;
} DATE_TIME, *PDATE_TIME;
typedef struct _DAPSDK_FORMAT_INFO
{
long lCodecID;
UCHAR szCodecName[128];
long lSamplingRate;
long lNumChannel;
} FORMAT_INFO, *PFORMAT_INFO;
//-- SDK and firmware version info structure --//
//
// used in GetSDKVersion()
// used in GetDeviceProperties( kFirmwareVersion, kHardwareVersion)
typedef struct _DAPSDK_VERSION
{
WORD major;
WORD minor;
WORD build;
WORD specialBuild;
} DAPSDK_VERSION, *PDAPSDK_VERSION;
//-- Memory Storage Information Structure --//
typedef struct _DAPSDK_STORAGE_INFO
{
ULONG totalH;
ULONG totalL;
ULONG freeH;
ULONG freeL;
} DAPSDK_STORAGE_INFO, *PDAPSDK_STORAGE_INFO;
//-- Identification structure --//
// same for RootItem, ParentItem and Item now //
typedef struct _DAPSDK_ID
{
long lID; // stores the unique ID
long lType; // stores the type (see enum above)
BSTR bstrName; // stores the name
} DAPSDK_ID, *PDAPSDK_ID;
//////////////////////////////////////////////////////
// NomadII stuffs //
//////////////////////////////////////////////////////
typedef struct _DAPSDK_RADIOPRESET
{
DWORD dwPresetIndex;
DWORD dwPresetValue;
} RADIOPRESET, *PRADIOPRESET;
// device info struct
typedef struct _DAPSDK_DEVICE_INFO
{
BYTE cDeviceId[16]; // player's ID
long dwFirmwareVersion; // player's firmware version
long dwHardwareVersion; // player's hardware version
char cDeviceName[32]; // player's name w/o NULL terminator
BYTE byPowerSource; // player's power source status in percent
} DAPSDK_DEVICE_INFO, *PDAPSDK_DEVICE_INFO;
enum
{
kASCII = 0,
kBINARY,
kUNICODE,
};
//////////////////////////////////////////////////////
// Item type for Jukebox (used by lRootItemType, //
// lParentItemType, lItemType parameter) //
//////////////////////////////////////////////////////
enum
{
kAudioTrackType = 1, // this is a audio track
kPlaylistType, // this is a track in the playlist
kDataFileType, // this is a data file
kDataFolderType, // this is a data file folder
};
/////////////////////////////////////////////////////////
// Item type for NomadII (used in lItemType parameter) //
/////////////////////////////////////////////////////////
enum
{
kInternalMemType = 0, // this item resides in internal memory
kExternalMemType, // this item resides in external (removeable) media
};
// Device Property Type Constant
//-- Device Property type (used by lDevicePropertyType parameter in --//
// GetDeviceProperties/SetDeviceProperties --//
enum
{
//////////////////////////////////////////////////////
// JukeBox & NomadII shared stuffs //
//////////////////////////////////////////////////////
kDeviceSerialNumberValue = 1, // GET, <NOMAD II>given the Item type
// in "lpValue" parameter, the return value
// is a pointer to the serial number
// of the specified media.
kFirmwareVersion, // GET, return value is a pointer to
// DAPSDK_VERSION structure indicating the
// current firmware version in the device.
kDeviceNameString, // GET, return value is a pointer to
// BSTR string.
kPowerSourceValue,
kStorageInfoStruct, // GET, return value is a pointer to
// DAPSDK_STORAGE_INFO structure indicating
// the current memory usage.
kDateTimeStruct, // GET/SET, return/set value is a pointer to
// DATE_TIME structure (defined in SDK 1.0)
kOwnerNameString, // GET/SET, return/set value is a pointer to BSTR
// string.
kAudioFormatCount, // GET, return value is a pointer to the number of
// audio format supported by device.
kAudioFormatInfoStruct, // GET, given the index value in "lpValue"
// parameter, the return value is a pointer to
// FORMATINFO structure (defined in SDK 1.0).
kLangEncodeSupport, // GET, returns unsigned long value
// 0x01 == Latin 1(CP1252), 0x80000000 == UNICODE
//////////////////////////////////////////////////////
// JukeBox stuffs //
//////////////////////////////////////////////////////
kHardwareVersion, // GET, return value is a pointer to
// DAPSDK_VERSION structure indicating the
// current hardware version in the device.
kAudioVolumeValue, // GET/SET, return/set value is the pointer to the
// volume level in percentage.
kAudioMuteValue, // GET/SET, return/set value is the pointer to the
// Mute status (1=on, 0=off).
// Treble level in percentage.
kEAXCount, // GET, return value is the pointer to the number
// of EAX settings.
kEAXNameString, // GET, given the index value in "lpValue"
// parameter, the return value is a pointer to
// a BSTR string.
kEAXAmountValue, // GET/SET, given the index value in "lpValue"
// parameter, the return value is the effect
// amount in percentage.
kEAXCurrentIndex, // GET/SET, the value in "lpValue" is used to set
// or retrieve the current EAX selection.
kAudioEQPresetCount, // GET, return value is the pointer to the number
// of EQ settings.
kAudioEQNameString, // GET, given the index value in "lpValue"
// parameter, the return value is a pointer to
// a BSTR string.
kAudioEQAmountValue, // GET/SET, return/set value is the pointer to the
// EQ amount in percentage.
kAudioEQCurrentIndex, // GET/SET, the value in "lpValue" is used to set
// or retrieve the current EQ selection.
//////////////////////////////////////////////////////
// NomadII stuffs //
//////////////////////////////////////////////////////
kFMRadioPresetCount, // GET, returns pointer to number of FM radio
// presets available in the player.
kFMRadioPresetValue, // GET/SET, given the preset index value,
// returns an existing value or sets a new
// preset FM preset. Value in kHz.
kFormatStorage // SET, Do format storage.
};
//Note that all index value is zero-based. Client should call the "kxxxxxxCount" property first before trying to get the value for individual settings in list-type of properties, i.e. kEAXNameString, kAudioFormatInfoStruct...
//Not all properties are readable and writable, some are read-only attributes. Those properties that are read-only are marked with the "GET" strings and those that are read and writable are marked as "GET/SET". Client should not call SetDeviceProperties() with the read-only property type, such call would fail.
//New Property types maybe supported in future by simply adding into the enum list, and publish to developers.
//////////////////////////////////////////////////////
// JukeBox stuffs //
//////////////////////////////////////////////////////
//-- Playback operation type (used by lPlayOperationType parameter in --//
//-- PlayControl() & QueueControl()) --//
enum
{
kPlayTrack = 1, // lpValue stores the pointer to the
// DAPSDK_ITEM_ID structure.
kStopTrack, // lpValue is not used, stop current track, no op
// if no track is currently playing.
kPauseTrack, // lpValue is not used, pause current track, no op
// if no track is currently playing.
kSetPlaybackPosition, // lpValue stores the pointer to the new playback
// position.
kQueueTrack, // lpValue stores the pointer to the
// DAPSDK_ITEM_ID structure.
kClearQueue, // lpValue is not used, clear existing queue.
};
#define TITLE "TITLE"
#define FILESIZE "FILE SIZE"
#define CODEC "CODEC"
#define ALBUM "ALBUM"
#define ARTIST "ARTIST"
#define GENRE "GENRE"
#define LENGTH "LENGTH"
#define TRACKNUM "TRACK NUM"
#define YEAR "YEAR"
#define PLAYONLY "PLAYONLY"
#define TRACKID "TRACK ID"
// new attribute for datafile and datafolder
#define MOD_FILETIME "MODIFIED FILETIME"
#define FILE_ATTRIB "FILE ATTRIB"
#define PARENT_FOLDER "PARENT FOLDER"
#define FOLDERNAME "FOLDER NAME" // data folder name for Nomad Jukebox
#define MULTI_ATTRIB "MULTI ATTRIB" // this is for user to change multiple file attribute at one time.
#define FILENAME "FILE NAME" // file name for Nomad II, data file name for Nomad Jukebox
#define ALLTRACKSKEY -1
//////////////////////////////////////////////////////
// NomadII stuffs //
//////////////////////////////////////////////////////
#define DOS_FILEATTRIB "DOS_FILEATTRIB"
#define DOS_DATETIME "DOS_DATETIME"
//////////////////////////////////////////////////////////////////////////
// ICTJukebox (Interface 1) Methods //
//////////////////////////////////////////////////////////////////////////
// {DFC9207F-4B64-11D4-A4ED-00A0C98E46CC}
DEFINE_GUID(IID_ICTJukebox,
0xdfc9207f, 0x4b64, 0x11d4, 0xa4, 0xed, 0x00, 0xa0, 0xc9, 0x8e, 0x46, 0xcc);
interface ICTJukebox : public IUnknown
{
virtual HRESULT STDMETHODCALLTYPE CancelTransfer(
/*[in]*/long lDeviceID) = 0;
virtual HRESULT STDMETHODCALLTYPE RenamePlaylist(
/*[in]*/long lDeviceID,
/*[in]*/long lPlaylistID,
/*[in]*/BSTR bstrName) = 0;
virtual HRESULT STDMETHODCALLTYPE RemoveTracksFromPlaylist(
/*[in]*/long lDeviceID,
/*[in]*/long lTrackCount,
/*[in]*/long* lpTrackList,
/*[in]*/long lPlaylist) = 0;
virtual HRESULT STDMETHODCALLTYPE AddTracksToPlaylist(
/*[in]*/long lDeviceID,
/*[in]*/long lTrackCount,
/*[in]*/long* lpTrackList,
/*[in]*/long lPlaylist) = 0;
virtual HRESULT STDMETHODCALLTYPE InsertPlaylist(
/*[in]*/long lDeviceID,
/*[in]*/BSTR bstrPlaylistName,
/*[out]*/long* lpPlaylistID) = 0;
virtual HRESULT STDMETHODCALLTYPE DeletePlaylist(
/*[in]*/long lDeviceID,
/*[in]*/long lPlaylistID) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextTrackInPlaylist(
/*[in]*/long lDeviceID,
/*[in]*/long lPlaylistID,
/*[out]*/long* lpTrackID,
/*[out]*/BSTR* lpbstrTrackName) = 0;
virtual HRESULT STDMETHODCALLTYPE FindFirstTrackInPlaylist(
/*[in]*/long lDeviceID,
/*[in]*/long lPlaylistID,
/*[out]*/long* lpTrackID,
/*[out]*/BSTR* lpbstrTrackName) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextPlaylist(
/*[in]*/long lDeviceID,
/*[out]*/long* lpPlaylistID,
/*[out]*/BSTR* lpbstrPlaylistName) = 0;
virtual HRESULT STDMETHODCALLTYPE FindFirstPlaylist(
/*[in]*/long lDeviceID,
/*[out]*/long* lpPlaylistID,
/*[out]*/BSTR* lpbstrPlaylistName) = 0;
virtual HRESULT STDMETHODCALLTYPE ChangeTrackInfo(
/*[in]*/long lDeviceID,
/*[in]*/long lTarckID,
/*[in]*/long lSize,
/*[in]*/IUnknown* lpTrackInfo) = 0;
virtual HRESULT STDMETHODCALLTYPE DeleteTrack(
/*[in]*/long lDeviceID,
/*[in]*/long lTrackID) = 0;
virtual HRESULT STDMETHODCALLTYPE InsertTrack(
/*[in]*/long lDeviceID,
/*[in]*/BSTR bstrFilePath,
/*[in]*/long lSize,
/*[in]*/IUnknown* lpTrackInfo,
/*[out]*/long* lpTrackID) = 0;
virtual HRESULT STDMETHODCALLTYPE GetTrackInfo(
/*[in]*/long lDeviceID,
/*[in]*/long lTrackID,
/*[in]*/long lInSize,
/*[out]*/long* lpOutSize,
/*[out]*/IUnknown* lpTrackInfo) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextTrack(
/*[in]*/long lDeviceID,
/*[in]*/long lKeyID,
/*[out]*/long* lpTrackID,
/*[out]*/BSTR* lpbstrName) = 0;
virtual HRESULT STDMETHODCALLTYPE FindFirstTrack(
/*[in]*/long lDeviceID,
/*[in]*/long lKeyID,
/*[out]*/long* lpTrackID,
/*[out]*/BSTR* lpbstrName) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextKey(
/*[in]*/long lDeviceID,
/*[in]*/long lRootKeyID,
/*[out]*/long* lpKeyID,
/*[out]*/BSTR* lpbstrName) = 0;
virtual HRESULT STDMETHODCALLTYPE FindFirstKey(
/*[in]*/long lDeviceID,
/*[in]*/long lRootKeyID,
/*[out]*/long* lpKeyID,
/*[out]*/BSTR* lpbstrName) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextRootKey(
/*[in]*/long lDeviceID,
/*[out]*/long* lpRootKeyID,
/*[out]*/BSTR* lpbstrName) = 0;
virtual HRESULT STDMETHODCALLTYPE FindFirstRootKey(
/*[in]*/long lDeviceID,
/*[out]*/long* lpRootKeyID,
/*[out]*/BSTR* lpbstrName) = 0;
virtual HRESULT STDMETHODCALLTYPE SetOwnerName(
/*[in]*/long lDeviceID,
/*[in]*/BSTR bstrName) = 0;
virtual HRESULT STDMETHODCALLTYPE GetOwnerName(
/*[in]*/long lDeviceID,
/*[out]*/BSTR* lpbstrName) = 0;
virtual HRESULT STDMETHODCALLTYPE SetDateTime(
/*[in]*/long lDeviceID,
/*[out]*/IUnknown* lpDateTime) = 0;
virtual HRESULT STDMETHODCALLTYPE GetDateTime(
/*[in]*/long lDeviceID,
/*[out]*/IUnknown* lpDateTime) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextFormatSupport(
/*[in]*/long lDeviceID,
/*[out]*/IUnknown* lpFormatInfo) = 0;
virtual HRESULT STDMETHODCALLTYPE FindFirstFormatSupport(
/*[in]*/long lDeviceID,
/*[out]*/IUnknown* lpFormatInfo) = 0;
virtual HRESULT STDMETHODCALLTYPE GetStorageInfo(
/*[in]*/long lDeviceID,
/*[out]*/unsigned long* lpTotalMemHigh,
/*[out]*/unsigned long* lpTotalMemLow,
/*[out]*/unsigned long* lpFreeMemHigh,
/*[out]*/unsigned long* lpFreeMemLow ) = 0;
virtual HRESULT STDMETHODCALLTYPE GetDeviceInfo(
/*[in]*/long lDeviceID,
/*[out]*/IUnknown* lpDeviceInfo) = 0;
virtual HRESULT STDMETHODCALLTYPE GetDeviceCount(
/*[out]*/long* lpDeviceCount) = 0;
virtual HRESULT STDMETHODCALLTYPE SetCallbackWindow(
/*[in]*/long lDeviceID,
/*[in]*/long hWnd) = 0;
virtual HRESULT STDMETHODCALLTYPE GetSDKVersion(
/*[out]*/long* lpVersion) = 0;
virtual HRESULT STDMETHODCALLTYPE ShutDown() = 0;
virtual HRESULT STDMETHODCALLTYPE Initialize() = 0;
};
//////////////////////////////////////////////////////////////////////////
// ICTJukebox2 (Interface 2) Methods //
//////////////////////////////////////////////////////////////////////////
DEFINE_GUID(IID_ICTJukebox2,
0xdfc92080, 0x4b64, 0x11d4, 0xa4, 0xed, 0x00, 0xa0, 0xc9, 0x8e, 0x46, 0xcc);
interface ICTJukebox2 : public IUnknown
{
virtual HRESULT STDMETHODCALLTYPE Initialize2() = 0;
virtual HRESULT STDMETHODCALLTYPE ShutDown2() = 0;
virtual HRESULT STDMETHODCALLTYPE SetCallbackWindow2(
long lDeviceID,
long hWnd ) = 0;
virtual HRESULT STDMETHODCALLTYPE GetDeviceCount2(
long* lpDeviceCount ) = 0;
//-- Canceling I/O --//
virtual HRESULT STDMETHODCALLTYPE CancelTransfer2(
long lDeviceID ) = 0;
//-- GetSDKVersion2() Fucntion Descriptions --//
// This function overides the same function in interface 1, this is to
// return a more meaningful version information to the client which is
// clearly specified in the DAPSDK_VERSION structure
virtual HRESULT STDMETHODCALLTYPE GetSDKVersion2(
IUnknown* lpSDKVersion ) = 0;
//_______________________ Querying RootItem __________________________//
virtual HRESULT STDMETHODCALLTYPE FindFirstRootItem (
long lDeviceID,
IUnknown* lpRootItemID ) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextRootItem (
long lDeviceID,
IUnknown* lpRootItemID ) = 0;
//______________________ Querying ParentItem __________________________//
virtual HRESULT STDMETHODCALLTYPE FindFirstParentItem (
long lDeviceID,
IUnknown* lRootItemID,
IUnknown* lpParentItemID ) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextParentItem (
long lDeviceID,
IUnknown* lRootItemID,
IUnknown* lpParentItemID ) = 0;
//______________________ ParentItem Management __________________________ //
//-- AddParentItem() Fucntion Descriptions --//
// Client can only add Parent Item of the same type as the RootItem. For
// example, client cannot add a kDataFileType Parent item into a RootItem
// type of kAudioTrackType.
//
// As of current firmware implementation, client can only add ParentItem
// into a RootItem that has a type of kPlaylistType. Adding ParentItem into
// other RootItem type will fail.
virtual HRESULT STDMETHODCALLTYPE AddParentItem (
long lDeviceID,
IUnknown* lRootItemID,
IUnknown* lParentItemID ) = 0;
//-- DeleteParentItem() Function Description --//
// Client can only delete ParentItem of type kPlaylistType. Deleting other
// ParentItem type will fail.
virtual HRESULT STDMETHODCALLTYPE DeleteParentItem (
long lDeviceID,
IUnknown* lParentItemID ) = 0;
//-- RenameParentItem() Function Description --//
// Client can only rename ParentItem of type kPlaylistType. Renaming other
// ParentItem type will fail.
//
// The updated DAPSDK_PARENTITEM_ID structure is returned in lParentItemID
// parameter.
virtual HRESULT STDMETHODCALLTYPE RenameParentItem (
long lDeviceID,
IUnknown* lParentItemID,
BSTR bstrNewParentItemName ) = 0;
//__________________________ Querying Item ______________________________//
virtual HRESULT STDMETHODCALLTYPE FindFirstItem (
long lDeviceID,
IUnknown* lParentItemID,
IUnknown* lpItemID ) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextItem (
long lDeviceID,
IUnknown* lParentItemID,
IUnknown* lpItemID ) = 0;
//_____________________ Getting Item Attributes __________________________//
//-- GetItemAttribute() Function Description --//
// This function returns the TrackInfo data for all Item type. But for
// kDataFileType and kPlaylistFileType, the TrackInfo data contain only
// file name, file type and file size. In contrast, the item attribute
// for a kAudioTrackType may contain all information similar to the ID3tag
// information that a typical MP3 file has.
virtual HRESULT STDMETHODCALLTYPE GetItemAttribute (
long lDeviceID,
IUnknown* lpItemID,
long lInItemInfoSize,
long* lOutItemInfoSize,
IUnknown* lpItemInfo ) = 0;
//-- SetItemAttribute() Function Description --//
// This function allows client to set TrackInfo attributes of a
// kAudioTrackItem only. Setting other item type will fail.
//
// It allows client to set a particular attribute data according to the name
// and type given in the parameters. Note that only one attribute can be set
// at a time.
virtual HRESULT STDMETHODCALLTYPE SetItemAttribute (
long lDeviceID,
IUnknown* lpItemID,
BSTR bstrAttributeName,
long lAttributeType,
long lAttributeDataSize,
IUnknown* lpAttributeData ) = 0;
//____________________________ Item Management ___________________________//
//-- AddItem() Function Description --//
// This function initiates the file download from the computer to the
// device. Client should call this function to download audio tracks
// like MP3, WMA and WAVE and data files. Client are not allow
// to download an item of kPlaylistType, use AddItemsToParentItem to add
// item of type kPlaylistType.
virtual HRESULT STDMETHODCALLTYPE AddItem (
long lDeviceID,
long lItemType,
BSTR bstrSrcFileName,
long lItemInfoSize,
IUnknown* lpItemInfo) = 0;
//-- AddItemsToParentItem() Function Description --//
// Client call this function to add kAudioTrackType item into the ParentItem
// of type kPlaylistType. Only kAudioTrackType items are accepted, and only
// ParentItem of type kPlaylistType can accept such addition.
virtual HRESULT STDMETHODCALLTYPE AddItemsToParentItem(
long lDeviceID,
IUnknown* lpParentItemID,
long lItemIDCount,
IUnknown* lpItemIDList ) = 0;
//-- DeleteItem() Function Description --//
// Client can call this function to remove item of type kAudioTrackType and
// kDataFileType. You cannot remove kPlaylistType item here.
virtual HRESULT STDMETHODCALLTYPE DeleteItem (
long lDeviceID,
IUnknown* lpItemID ) = 0;
//-- GetItem() Function Description --//
// Client can call this function to retrieve item that are kAudioTrackType
// and kDataFileType from the device to the computer. Note that client
// cannot retrieve item of type kPlaylistItem
virtual HRESULT STDMETHODCALLTYPE GetItem (
long lDeviceID,
BSTR bstrDestinationFileName,
IUnknown* lpItemID ) = 0;
//________________________ Device Properties ____________________________//
virtual HRESULT STDMETHODCALLTYPE GetDeviceProperties (
long lDeviceID,
long lDevicePropertyType,
IUnknown* lpValue ) = 0;
virtual HRESULT STDMETHODCALLTYPE SetDeviceProperties (
long lDeviceID,
long lDevicePropertyType,
IUnknown* lpValue ) = 0;
//_______________________ Playback control ______________________________//
virtual HRESULT STDMETHODCALLTYPE PlayControl (
long lDeviceID,
long lPlayOperationType,
IUnknown* lpValue ) = 0;
virtual HRESULT STDMETHODCALLTYPE QueueControl (
long lDeviceID,
long lQueueOperationType,
IUnknown* lpValue ) = 0;
};
//////////////////////////////////////////////////////////////
// ICTNomad2 Methods //
//////////////////////////////////////////////////////////////
// {368953D4-6A2F-4787-BC6F-4047A39A7557}
DEFINE_GUID(IID_ICTNomad2,
0x368953d4, 0x6a2f, 0x4787, 0xbc, 0x6f, 0x40, 0x47, 0xa3, 0x9a, 0x75, 0x57);
interface ICTNomad2 : public IUnknown
{
virtual HRESULT STDMETHODCALLTYPE Initialize() = 0;
virtual HRESULT STDMETHODCALLTYPE ShutDown() = 0;
virtual HRESULT STDMETHODCALLTYPE SetCallbackWindow(
/*[in]*/long lDeviceID,
/*[in]*/long hWnd) = 0;
virtual HRESULT STDMETHODCALLTYPE GetDeviceCount(
/*[out]*/long* lpDeviceCount) = 0;
virtual HRESULT STDMETHODCALLTYPE CancelTransfer(
/*[in]*/long lDeviceID) = 0;
virtual HRESULT STDMETHODCALLTYPE GetSDKVersion(
/*[out]*/IUnknown* lpVersion) = 0;
//__________________________ Querying Item ______________________________//
virtual HRESULT STDMETHODCALLTYPE FindFirstItem (
long lDeviceID,
IUnknown* lParentItemID,
IUnknown* lpItemID ) = 0;
virtual HRESULT STDMETHODCALLTYPE FindNextItem (
long lDeviceID,
IUnknown* lParentItemID,
IUnknown* lpItemID ) = 0;
//_____________________ Getting Item Attributes __________________________//
//-- GetItemAttribute() Function Description --//
// This function returns the TrackInfo data for all Item type. But for
// kDataFileType and kPlaylistFileType, the TrackInfo data contain only
// file name, file type and file size. In contrast, the item attribute
// for a kAudioTrackType may contain all information similar to the ID3tag
// information that a typical MP3 file has.
virtual HRESULT STDMETHODCALLTYPE GetItemAttribute (
long lDeviceID,
IUnknown* lpItemID,
long lInItemInfoSize,
long* lOutItemInfoSize,
IUnknown* lpItemInfo ) = 0;
//____________________________ Item Management ___________________________//
//-- AddItem() Function Description --//
// This function initiates the file download from the computer to the
// device. Client should call this function to download audio tracks
// like MP3, WMA and WAVE and data files. Client are not allow
// to download an item of kPlaylistType, use AddItemsToParentItem to add
// item of type kPlaylistType.
virtual HRESULT STDMETHODCALLTYPE AddItem (
long lDeviceID,
long lItemType,
BSTR bstrSrcFileName,
long lItemInfoSize,
IUnknown* lpItemInfo) = 0;
//-- DeleteItem() Function Description --//
// Client can call this function to remove item of type kAudioTrackType and
// kDataFileType. You cannot remove kPlaylistType item here.
virtual HRESULT STDMETHODCALLTYPE DeleteItem (
long lDeviceID,
IUnknown* lpItemID ) = 0;
//-- GetItem() Function Description --//
// Client can call this function to retrieve item that are kAudioTrackType
// and kDataFileType from the device to the computer. Note that client
// cannot retrieve item of type kPlaylistItem
virtual HRESULT STDMETHODCALLTYPE GetItem (
long lDeviceID,
BSTR bstrDestinationFileName,
IUnknown* lpItemID ) = 0;
//________________________ Device Properties ____________________________//
virtual HRESULT STDMETHODCALLTYPE GetDeviceProperties (
long lDeviceID,
long lDevicePropertyType,
IUnknown* lpValue ) = 0;
virtual HRESULT STDMETHODCALLTYPE SetDeviceProperties (
long lDeviceID,
long lDevicePropertyType,
IUnknown* lpValue ) = 0;
};
#ifdef __cplusplus
}
#endif // __cplusplus
#endif