Media Center Core Commands: Difference between revisions
No edit summary |
|||
Line 1,093: | Line 1,093: | ||
== Specifying Zones == |
== Specifying Zones == |
||
Media Center [[#Playback|Core Commands]] are targeted to a specific playback zone by combining the command's parameter value with the zone specifier value from the '''Zone Specifiers''' table. MC version 16.0.118 has simplified command line specification of parameter and zone, eliminating the need for manual calculations prior to usage. The '''/MCC''' option now accepts an alternate syntax in the format of <tt>''[value]'':''[zone index]''</tt> for the parameter (see examples). The text that follows documents and describes the original (and still valid) specification, which would be used when issuing an '''MCC''' command through a mechanism other than the '''MC16.exe''' command. |
Media Center [[#Playback|Core Commands]] are targeted to a specific playback zone by combining the command's parameter value with the zone specifier value from the '''Zone Specifiers''' table. MC zones are integer indexes, from 0 to n, where 0 is the the first zone, 1 is the second zone, and so on. Zone indexes correspond to the zone order displayed under Playing Now in the Media Center tree. MC version 16.0.118 has simplified command line specification of parameter and zone, eliminating the need for manual calculations prior to usage. The '''/MCC''' option now accepts an alternate syntax in the format of <tt>''[value]'':''[zone index]''</tt> for the parameter (see examples). The text that follows documents and describes the original (and still valid) specification, which would be used when issuing an '''MCC''' command through a mechanism other than the '''MC16.exe''' command. |
||
{| border="1" cellpadding="3" cellspacing="0" align="right" style="text-align:right;" |
{| border="1" cellpadding="3" cellspacing="0" align="right" style="text-align:right;" |
Revision as of 01:21, 27 November 2011
Introduction
MC Core Commands are used to control various aspects of Media Center via software or command line. Each command consists of a name (or number), followed by an optional parameter which selects or specifies the particular command behavior.
The MC Core Commands in the tables below have been auto-generated from the file MCCommands.h and should be accurate as of:
MCCommands.h: 2011-06-21 MC Version: 16.0.116
The full, C++ header is available here (caution: may be out of date): J. River Media Core Commands Header File
Notes
- Save the MCCommands.h file to your hard drive to avoid potential line break issues.
- Commands have changed over time; use the Wiki's page history to see previous versions of this page. Some commands may only work with the latest version of Media Center.
How To Issue Media Core Commands
Look up the command name / number and its parameter in the tables below. For example, the command to toggle between play and pause is MCC_PLAY_PAUSE. It has command number (enum value) 10000 and its accompanying parameter is ignored. Some MCC commands may be targeted a particular Zone - see Specifying Zones.
Issuing a command from the command line
The general syntax for issuing an MCC command from the Windows command line (or equivalent) is:
MC<version>.exe /MCC <command number>, <parameter>
Example: To toggle between play and pause in MC16, use the command:
MC16.exe /MCC 10000, 0
Note: The MCC commands can be entered in Vista and Windows 7 directly into Search Files and Programs under the Windows Start menu, or as commands in a Windows command shell, which can be launched in Vista and Windows 7 by entering cmd.exe in Search Files and Programs under the Windows Start menu. It is available under the Accessories menu as Command Prompt in previous versions of Windows.
Issuing a command from C++
The calling syntax for posting a WM_MC_COMMAND -based message to the MC frame is demonstrated in the example below.
Example: To post a command to toggle between play and pause
HWND hwndMC = FindWindow(_T("MJFrame"), NULL); PostMessage(hwndMC, WM_MC_COMMAND, MCC_PLAY_PAUSE, 0);
Notes on usage
- Use command numbers when calling from the command line, enum names from within software (e.g. MCC_PLAY_PAUSE).
- Set parameter to 0 if unused.
MC Commands
Playback
Range: 10,000 to 20,000
Note: See Specifying Zones to learn about issuing commands to a specific Zone.
Enum | Command | Parameter |
---|---|---|
10000 | MCC_PLAY_PAUSE | ignore |
10001 | MCC_PLAY | ignore |
10002 | MCC_STOP | BOOL bDisplayWarning |
10003 | MCC_NEXT | BOOL bNotActualNext |
10004 | MCC_PREVIOUS | ignore |
10005 | MCC_SHUFFLE | 0: toggle shuffle mode; 1: shuffle, jump to PN; 2: shuffle, no jump; 3: off; 4: on; 5:automatic |
10006 | MCC_CONTINUOUS | 0: toggle continuous; 1: off; 2: playlist; 3: song |
10007 | MCC_OBSOLETE_10007 | ignore |
10008 | MCC_FAST_FORWARD | int nRate |
10009 | MCC_REWIND | int nRate |
10010 | MCC_STOP_CONDITIONAL | ignore |
10011 | MCC_SET_ZONE | int nZoneIndex (-1 toggles forward, -2 toggles backwards) |
10012 | MCC_TOGGLE_DISPLAY | BOOL bExcludeTheaterView |
10013 | MCC_SHOW_WINDOW | BOOL bJumpToPlayingNow |
10014 | MCC_MINIMIZE_WINDOW | ignore |
10015 | MCC_PLAY_CPLDB_INDEX | int nIndex |
10016 | MCC_SHOW_DSP_STUDIO | ignore |
10017 | MCC_VOLUME_MUTE | 0: toggle; 1: mute; 2: unmute |
10018 | MCC_VOLUME_UP | int nDeltaPercent |
10019 | MCC_VOLUME_DOWN | int nDeltaPercent |
10020 | MCC_VOLUME_SET | int nPercent |
10021 | MCC_SHOW_PLAYBACK_OPTIONS | ignore |
10022 | MCC_SET_PAUSE | BOOL bPause (-1 toggles) |
10023 | MCC_SET_CURRENTLY_PLAYING_RATING | int nRating (0 means ?) |
10024 | MCC_SHOW_PLAYBACK_ENGINE_MENU | screen point (loword: x, hiword: y) -- must send directly |
10025 | MCC_PLAY_NEXT_PLAYLIST | ignore |
10026 | MCC_PLAY_PREVIOUS_PLAYLIST | ignore |
10027 | MCC_MAXIMIZE_WINDOW | ignore |
10028 | MCC_RESTORE_WINDOW | ignore |
10029 | MCC_SET_PLAYERSTATUS | PLAYER_STATUS_CODES Code |
10030 | MCC_SET_ALTERNATE_PLAYBACK_SETTINGS | BOOL bAlternateSettings (-1 toggles) |
10031 | MCC_SET_PREVIEW_MODE_SETTINGS | low 12 bits: int nDurationSeconds, high 12 bits: int nStartSeconds |
10032 | MCC_SHOW_PLAYBACK_ENGINE_DISPLAY_PLUGIN_MENU | screen point (loword: x, hiword: y) -- must send directly |
10033 | MCC_DVD_MENU | ignore |
10034 | MCC_SEEK_FORWARD | int nMilliseconds (0 means default -- varies depending on playback type) |
10035 | MCC_SEEK_BACK | int nMilliseconds (0 means default -- varies depending on playback type) |
10036 | MCC_STOP_AFTER_CURRENT_FILE | BOOL bStopAfterCurrentFile (-1 toggles) |
10037 | MCC_DETACH_DISPLAY | BOOL bDetach (-1 toggles) |
10038 | MCC_SET_MODE_ZONE_SPECIFIC | UI_MODES Mode |
10039 | MCC_STOP_INTERNAL | ignore |
10040 | MCC_PLAYING_NOW_REMOVE_DUPLICATES | ignore |
10041 | MCC_SHUFFLE_REMAINING | ignore |
10042 | MCC_PLAY_FIRST_FILE | ignore |
10043 | MCC_PLAY_LAST_FILE | ignore |
10044 | MCC_PLAY_FILE_BY_STRING | BSTR bstrFile (deleted by receiver) |
10045 | MCC_PLAY_FILE_AGAIN | ignore |
10046 | MCC_HANDLE_PLAYBACK_ERROR | ignore |
10047 | MCC_PLAY_AUTOMATIC_PLAYLIST | ignore |
10048 | MCC_SEEK | int nPositionMilliseconds |
10049 | MCC_CLEAR_PLAYING_NOW_ZONE_SPECIFIC | 0: all files; 1: leave playing file |
10050 | MCC_PLAY_RADIO_LAST_FM | ignore |
10051 | MCC_SHOW_ON_SCREEN_DISPLAY | 0: position bar |
File
Range: 20,000 to 21,000
Enum | Command | Parameter |
---|---|---|
20000 | MCC_OPEN_FILE | ignore |
20001 | MCC_OPEN_URL | ignore |
20002 | MCC_PRINT_LIST | ignore |
20003 | MCC_EXPORT_PLAYLIST | int nPlaylistID (-1 for active view) |
20004 | MCC_EXPORT_ALL_PLAYLISTS | BOOL bSilent |
20005 | MCC_UPLOAD_FILES | ignore |
20006 | MCC_EMAIL_FILES | ignore |
20007 | MCC_EXIT | int nMode (0: normal, 1: force close (close media server), 2: force close (allow media server)) |
20008 | MCC_UPDATE_LIBRARY | ignore |
20009 | MCC_CLEAR_LIBRARY | ignore |
20010 | MCC_EXPORT_LIBRARY | ignore |
20011 | MCC_BACKUP_LIBRARY | ignore |
20012 | MCC_RESTORE_LIBRARY | ignore |
20013 | MCC_LIBRARY_MANAGER | ignore |
20014 | MCC_IMAGE_ACQUIRE | ignore |
20015 | MCC_PRINT_IMAGES | MFKEY nKey (-1 for selected files) |
20016 | MCC_PRINT | ignore |
20017 | MCC_OBSOLETE_20017 | ignore |
20018 | MCC_OBSOLETE_20018 | ignore |
20019 | MCC_OBSOLETE_20019 | ignore |
20020 | MCC_OBSOLETE_20020 | ignore |
20021 | MCC_OBSOLETE_20021 | ignore |
20022 | MCC_OBSOLETE_20022 | ignore |
20023 | MCC_OBSOLETE_20023 | ignore |
20024 | MCC_IMPORT_PLAYLIST | ignore |
20025 | MCC_LOAD_LIBRARY | int nLibraryIndex |
20026 | MCC_SYNC_LIBRARY | ignore |
20027 | MCC_EMAIL_PODCAST_FEED | ignore |
20028 | MCC_LOAD_LIBRARY_READ_ONLY | int nLibraryIndex |
20029 | MCC_ADD_LIBRARY | ignore |
20030 | MCC_EXPORT_ITUNES | ignore |
20031 | MCC_DISCONNECT_LIBRARY | ignore |
20032 | MCC_SYNC_WITH_LIBRARY_SERVER | ignore |
20033 | MCC_STOP_ALL_ZONES | BOOL bStopRemoteZones |
20034 | MCC_CLONE_LIBRARY | int nLibraryIndex |
Edit
Range: 21,000 to 22,000
Enum | Command | Parameter |
---|---|---|
21000 | MCC_COPY | ignore |
21001 | MCC_PASTE | ignore |
21002 | MCC_SELECT_ALL | ignore |
21003 | MCC_SELECT_INVERT | ignore |
21004 | MCC_DELETE | BOOL bAggressive |
21005 | MCC_RENAME | ignore |
21006 | MCC_UNDO | ignore |
21007 | MCC_REDO | ignore |
21008 | MCC_QUICK_SEARCH | BOOL bRepeatLastSearch |
21009 | MCC_ADD_PLAYLIST | MEDIAFILE_INFO_ARRAY * paryFiles = NULL |
21010 | MCC_ADD_SMARTLIST | ignore |
21011 | MCC_ADD_PLAYLIST_GROUP | ignore |
21012 | MCC_PROPERTIES | MEDIAFILE_INFO_ARRAY * paryFiles = NULL (-1 toggles) (note: never PostMessage(...) a pointer) |
21013 | MCC_TOGGLE_TAGGING_MODE | ignore |
21014 | MCC_CUT | ignore |
21015 | MCC_DESELECT_ALL | ignore |
21016 | MCC_DELETE_ALL | BOOL bAggressive |
21017 | MCC_ADD_PODCAST_FEED | ignore |
21018 | MCC_EDIT_PODCAST_FEED | ignore |
21019 | MCC_ADD_PODCAST_DEFAULTS | ignore |
21020 | MCC_CREATE_STOCK_SMARTLISTS | ignore |
21021 | MCC_ENABLE_PODCAST_DOWNLOAD | ignore |
21022 | MCC_DISABLE_PODCAST_DOWNLOAD | ignore |
21023 | MCC_EDIT_PLAYLIST | ignore |
21024 | MCC_EDIT_PLAYING_NOW | int nZoneID |
21025 | MCC_EDIT_DISC_INFORMATION | ignore |
21026 | MCC_EDIT_SMARTLIST | int nPlaylistID |
21027 | MCC_REFRESH_PODCAST_FEED | ignore |
21028 | MCC_LOOKUP_MOVIE_INFORMATION | ignore |
21029 | MCC_ADD_ZONE | ignore |
21030 | MCC_ADD_AUTOMATIC_PLAYLIST | ignore |
21031 | MCC_SET_WRITE_TAGS | BOOL bWriteTags (-1 toggles) |
View
Range: 22,000 to 23,000
Enum | Command | Parameter |
---|---|---|
22000 | MCC_TOGGLE_MODE | -1: Next Mode, 0: Standard, 1: Mini, 2: Display, 3: Theater View, 4: Cover View |
22001 | MCC_THEATER_VIEW | 0:Toggle, 1:Home, 2:Playing Now, 3:Audio, 4:Images, 5:Video, 6:Playlists, 7:CD & DVD, 8:TV |
22002 | MCC_PARTY_MODE | ignore |
22003 | MCC_SHOW_TREE_ROOT | int nTreeRootIndex |
22004 | MCC_FIND_MEDIA | wchar * pstrSearch (note: memory will be deleted by receiver) |
22005 | MCC_BACK | int nLevels (0 does 1 level) |
22006 | MCC_FORWARD | int nLevels (0 does 1 level) |
22007 | MCC_REFRESH | int nFlags (1: no webpage refresh) |
22008 | MCC_SET_LIST_STYLE | int nListStyle (-1 toggles) |
22009 | MCC_SET_MODE | -3: Current Mode (update settings), -2: Close Display, -1: Next Mode, 0: Standard, 1: Mini, 2: Display, 3: Theater View, 4: Cover View |
22010 | MCC_OBSOLETE_22010 | ignore |
22011 | MCC_OBSOLETE_22011 | ignore |
22012 | MCC_SHOW_RECENTLYIMPORTED | ignore |
22013 | MCC_SHOW_TOPHITS | ignore |
22014 | MCC_SHOW_RECENTLYPLAYED | ignore |
22015 | MCC_SET_MEDIA_MODE | int nMediaMode |
22016 | MCC_CONFIGURE_ACCESS_CONTROL | ignore |
22017 | MCC_SET_SERVER_MODE | BOOL bServerMode |
22018 | MCC_SET_MODE_FOR_EXTERNAL_PROGRAM_LAUNCH | int nType (0: starting external app, 1: ending external app) |
22019 | MCC_SET_MODE_FOR_SECOND_INSTANCE_LAUNCH | UI_MODES Mode |
22020 | MCC_HOME | ignore |
22021 | MCC_ROLLUP_VIEW_HEADER | BOOL bRollup (-1: toggle) |
22022 | MCC_FOCUS_SEARCH_CONTROL | ignore |
22023 | MCC_SET_ACTIVE_VIEW_KEY | int nViewKey (-1: toggle, -2: toggle backwards, -3: new view) |
22024 | MCC_CLOSE_VIEW_KEY | int nViewKey (-1: current view) |
22025 | MCC_VIEW_ZOOM_SET | int nZoomPercentage |
22026 | MCC_VIEW_ZOOM_INCREMENT | int nZoomDeltaPercentage |
Tools
Range: 23,000 to 24,000
Enum | Command | Parameter |
---|---|---|
23000 | MCC_IMPORT | int nFlags (1: bDisableAlreadyRunningWarning, 2: bFirstImportMode) |
23001 | MCC_RIP_CD | ignore |
23002 | MCC_BURN | ignore |
23003 | MCC_RECORD_AUDIO | ignore |
23004 | MCC_CONVERT | ignore |
23005 | MCC_ANALYZE_AUDIO | ignore |
23006 | MCC_MEDIA_EDITOR | ignore |
23007 | MCC_CD_LABELER | ignore |
23008 | MCC_MUSICEX_MANAGER | ignore |
23009 | MCC_PLUGIN_MANAGER | ignore |
23010 | MCC_SKIN_MANAGER | ignore |
23011 | MCC_OPTIONS | int nPageID |
23012 | MCC_RENAME_CD_FILES | ignore |
23013 | MCC_WMLICENSE_MANAGER | ignore |
23014 | MCC_OBSOLETE_23014 | ignore |
23015 | MCC_HANDHELD_UPLOAD | loword: nDeviceSessionID (0 gets default), hiword: flags (1: sync only; 2: show warnings) |
23016 | MCC_HANDHELD_UPDATE_UPLOAD_WORKER_FINISHED | int nDeviceSessionID |
23017 | MCC_HANDHELD_CLOSE_DEVICE | int nDeviceSessionID |
23018 | MCC_HANDHELD_SHOW_OPTIONS | int nDeviceSessionID |
23019 | MCC_HANDHELD_INFO_DUMP | BOOL bShowInfo |
23020 | MCC_IMPORT_AUTO_RUN_NOW | BOOL bSilent |
23021 | MCC_IMPORT_AUTO_CONFIGURE | ignore |
23022 | MCC_HANDHELD_EJECT | int nDeviceSessionID |
23023 | MCC_RECORD_TV | ignore |
23024 | MCC_FIND_AND_REPLACE | ignore |
23025 | MCC_CLEAN_PROPERTIES | ignore |
23026 | MCC_FILL_TRACK_ORDER | ignore |
23027 | MCC_MOVE_COPY_FIELDS | ignore |
23028 | MCC_REMOVE_TAGS | ignore |
23029 | MCC_UPDATE_TAGS_FROM_DB | ignore |
23030 | MCC_UPDATE_DB_FROM_TAGS | ignore |
23031 | MCC_LOOKUP_TRACK_INFO_FROM_INTERNET | ignore |
23032 | MCC_SUBMIT_TRACK_INFO_TO_INTERNET | ignore |
23033 | MCC_GRACENOTE_MORE_LIKE_THIS_SONG | ignore |
23034 | MCC_FILL_PROPERTIES_FROM_FILENAME | ignore |
23035 | MCC_RENAME_FILES_FROM_PROPERTIES | ignore |
23036 | MCC_COVER_ART_ADD_FROM_FILE | ignore |
23037 | MCC_COVER_ART_QUICK_ADD_FROM_FILE | ignore |
23038 | MCC_COVER_ART_GET_FROM_INTERNET | ignore |
23039 | MCC_COVER_ART_SUBMIT_TO_INTERNET | ignore |
23040 | MCC_COVER_ART_GET_FROM_SCANNER | ignore |
23041 | MCC_COVER_ART_SELECT_SCANNER | ignore |
23042 | MCC_COVER_ART_GET_FROM_CLIPBOARD | ignore |
23043 | MCC_COVER_ART_COPY_TO_CLIPBOARD | ignore |
23044 | MCC_COVER_ART_REMOVE | ignore |
23045 | MCC_COVER_ART_PLAY | ignore |
23046 | MCC_COVER_ART_SAVE_TO_EXTERNAL_FILE | ignore |
23047 | MCC_COVER_ART_REBUILD_THUMBNAIL | ignore |
23048 | MCC_RINGTONE | ignore |
Help
Range: 24,000 to 25,000
Enum | Command | Parameter |
---|---|---|
24000 | MCC_HELP_CONTENTS | ignore |
24001 | MCC_HELP_HOWTO_IMPORT_FILES | ignore |
24002 | MCC_HELP_HOWTO_PLAY_FILES | ignore |
24003 | MCC_HELP_HOWTO_RIP | ignore |
24004 | MCC_HELP_HOWTO_BURN | ignore |
24005 | MCC_HELP_HOWTO_ORGANIZE_FILES | ignore |
24006 | MCC_HELP_HOWTO_VIEW_SCHEMES | ignore |
24007 | MCC_HELP_HOWTO_MANAGE_PLAYLISTS | ignore |
24008 | MCC_HELP_HOWTO_EDIT_PROPERTIES | ignore |
24009 | MCC_HELP_HOWTO_FIND | ignore |
24010 | MCC_HELP_HOWTO_CONFIGURE | ignore |
24011 | MCC_CHECK_FOR_UPDATES | ignore |
24012 | MCC_BUY | ignore |
24013 | MCC_INSTALL_LICENSE | ignore |
24014 | MCC_REGISTRATION_INFO | ignore |
24015 | MCC_PLUS_FEATURES | ignore |
24016 | MCC_INTERACT | ignore |
24017 | MCC_SYSTEM_INFO | ignore |
24018 | MCC_ABOUT | ignore |
24019 | MCC_CONFIGURE_DEBUG_LOGGING | ignore |
24020 | MCC_WIKI | ignore |
24021 | MCC_TEST | ignore |
24022 | MCC_SHOW_EULA | ignore |
24023 | MCC_BENCHMARK | ignore |
Tree
Range: 25,000 to 26,000
Enum | Command | Parameter |
---|---|---|
25000 | MCC_ADD_VIEW_SCHEME | ignore |
25001 | MCC_EDIT_VIEW_SCHEME | ignore |
25002 | MCC_OBSOLETE_25002 | ignore |
25003 | MCC_OBSOLETE_25003 | ignore |
25004 | MCC_OBSOLETE_25004 | ignore |
25005 | MCC_OBSOLETE_25005 | ignore |
25006 | MCC_OBSOLETE_25006 | ignore |
25007 | MCC_OBSOLETE_25007 | ignore |
25008 | MCC_TREE_ADD_DIRECTORY | ignore |
25009 | MCC_TREE_IMPORT | ignore |
25010 | MCC_TREE_ADD_CD_FOLDER | ignore |
25011 | MCC_UPDATE_FROM_CD_DATABASE | ignore |
25012 | MCC_SUBMIT_TO_CD_DATABASE | ignore |
25013 | MCC_TREE_RIP | ignore |
25014 | MCC_CLEAR_PLAYING_NOW | 0: all files; 1: leave playing file |
25015 | MCC_COPY_LISTENING_TO | BOOL bPaste |
25016 | MCC_TREE_SET_EXPANDED | 0: collapsed; 1: expanded |
25017 | MCC_RESET_VIEW_SCHEMES | ignore |
25018 | MCC_TREE_ERASE_CD_DVD | ignore |
25019 | MCC_UPDATE_FROM_CDPLAYER_INI | ignore |
25020 | MCC_TREE_EJECT | ignore |
25021 | MCC_TREE_ADD_VIRTUAL_DEVICE | ignore |
25022 | MCC_TREE_RENAME_PLAYLIST | int nPlaylistID |
25023 | MCC_TWITTER_LISTENING_TO | ignore |
25024 | MCC_SCROBBLE_LISTENING_TO | ignore |
List
Range: 26,000 to 27,000
Enum | Command | Parameter |
---|---|---|
26000 | MCC_LIST_UPDATE_ORDER | ignore |
26001 | MCC_LIST_SHUFFLE_ORDER | ignore |
26002 | MCC_LIST_IMPORT | ignore |
26003 | MCC_LIST_REMOVE_ORDER | ignore |
26004 | MCC_LOCATE_FILE | int nLocation (-1: on disk (internal); -2: on disk (external); 0-n: library field index) |
26005 | MCC_LIST_MOVE_DISK_FILES | ignore |
26006 | MCC_LIST_INCREMENT_SELECTION | int nDelta |
26007 | MCC_LIST_REMOVE_DUPLICATES | ignore |
26008 | MCC_LIST_AUTO_SIZE_COLUMN | int nColumn, zero-based column index (-1: all) |
26009 | MCC_LIST_CUSTOMIZE_VIEW | ignore |
26010 | MCC_LIST_COPY_DISK_FILES | ignore |
26011 | MCC_LIST_SET_RIP_CHECK | 0: uncheck, 1: check, -1: toggle |
26012 | MCC_LIST_DOWNLOAD | ignore |
26013 | MCC_LIST_GET_LIST_POINTER | ignore |
26014 | MCC_LOCATE_STACK | ignore |
26015 | MCC_SET_AS_STACK_TOP | ignore |
26016 | MCC_EXPAND_STACK | ignore |
26017 | MCC_COLLAPSE_STACK | ignore |
26018 | MCC_AUTOSTACK | 0: by name, 1: artist, album, name, 2: Artist, Album, Track # and Name |
26019 | MCC_CHECK_STACKS | ignore |
26020 | MCC_STACK | int nZeroBasedSelection |
26021 | MCC_UNSTACK | ignore |
26022 | MCC_ADD_TO_STACK | ignore |
26023 | MCC_PANE_RESET_SELECTION | int nPaneIndex (-1 resets all) |
26024 | MCC_LIST_REMOVE_ALL | ignore |
26025 | MCC_LIST_LOCK | BOOL bLock (-1 toggles) |
26026 | MCC_PANE_SET_EXPANDED | loword: nPaneIndex, hiword: 0: collapsed; 1: expanded |
System
Range: 27,000 to 28,000
Enum | Command | Parameter |
---|---|---|
27000 | MCC_KEYSTROKE | int nKeyCode |
27001 | MCC_SHUTDOWN | int nMode (0: shutdown; 1: sleep; 2: hibernate; 3: restart) (based on CSystemShutdown::EShutdownModes) |
Playback Engine
Range: 28,000 to 29,000
Enum | Command | Parameter |
---|---|---|
28000 | MCC_PLAYBACK_ENGINE_ZOOM_IN | ignore |
28001 | MCC_PLAYBACK_ENGINE_ZOOM_OUT | ignore |
28002 | MCC_PLAYBACK_ENGINE_UP | ignore |
28003 | MCC_PLAYBACK_ENGINE_DOWN | ignore |
28004 | MCC_PLAYBACK_ENGINE_LEFT | ignore |
28005 | MCC_PLAYBACK_ENGINE_RIGHT | ignore |
28006 | MCC_PLAYBACK_ENGINE_ENTER | ignore |
28007 | MCC_PLAYBACK_ENGINE_FIRST | ignore |
28008 | MCC_PLAYBACK_ENGINE_LAST | ignore |
28009 | MCC_PLAYBACK_ENGINE_NEXT | ignore |
28010 | MCC_PLAYBACK_ENGINE_PREVIOUS | ignore |
28011 | MCC_PLAYBACK_ENGINE_PAUSE | BOOL bPause (-1 toggles) |
28012 | MCC_IMAGE_PAN_AND_ZOOM | BOOL bPanAndZoom (-1 toggles) |
28013 | MCC_IMAGE_TOGGLE_EFFECT | int nDelta |
28014 | MCC_IMAGE_RAPID_ZOOM | int nRapidZoom |
28015 | MCC_DVD_SET_AUDIO_STREAM | int nAudioStream (-1 toggles) |
28016 | MCC_DVD_SHOW_MENU | ignore |
28017 | MCC_TV_RECORD | ignore |
28018 | MCC_TV_SNAPSHOT | ignore |
28019 | MCC_TV_CHANGE_STANDARD | ignore |
28020 | MCC_PLAYBACK_ENGINE_OSD_VIDEO_PROC_AMP | int nIndex (0 for brightness, 1 for contrast, etc. -1 cycles) |
28021 | MCC_PLAYBACK_ENGINE_SET_CUR_VIDEO_PROC_AMP | int nStep (... -2, -1, 1, 2, etc. 0 is invalid and will default to 1) |
28022 | MCC_PLAYBACK_ENGINE_SET_ASPECT_RATIO | -1: cycles; 0 - 8: selects individual Aspect Ratio Modes |
28023 | MCC_PLAYBACK_ENGINE_SCROLL_UP | ignore |
28024 | MCC_PLAYBACK_ENGINE_SCROLL_DOWN | ignore |
28025 | MCC_PLAYBACK_ENGINE_SCROLL_LEFT | ignore |
28026 | MCC_PLAYBACK_ENGINE_SCROLL_RIGHT | ignore |
28027 | MCC_TV_SET_SAVE_TIME_SHIFTING | int nSaveMode (0 - 6, -1 cycles by incrementing, -2 cycles by decrementing) |
28028 | MCC_PLAYBACK_ENGINE_ZOOM_TO_PRESET | int 0 to fit window, 1 for 100%, 2 for 200% |
28029 | MCC_TV_SCAN_PROGRAMMING_EVENTS | ignored |
28030 | MCC_TV_CHANGE_CHANNEL_KEY | int nKey |
28031 | MCC_TV_PLAY_CHANNEL_POSITION | int Playlist position |
Other
Range: 30,000 to 31,000
Enum | Command | Parameter |
---|---|---|
30000 | MCC_RELOAD_MC_VIEW | ignore |
30001 | MCC_CUSTOMIZE_TOOLBAR | ignore |
30002 | MCC_PLAY_TV | ignore |
30003 | MCC_UPDATE_WEBPAGES | ignore |
30004 | MCC_SHOW_RUNNING_MC | BOOL bToggleVisibility |
30005 | MCC_SHOW_MENU | int nMenuID |
30006 | MCC_TUNE_TV | ignore |
30007 | MCC_PLAY_PLAYLIST | int nPlaylistID |
30008 | MCC_SENDTO_TOOL | 0: labeler; 1: media editor; 2: default editor; 3: ftp upload; 4: email; 5 Menalto Gallery; 6 Web Gallery |
30009 | MCC_SHOW_VIEW_INFO | new CMCViewInfo * (for internal use only) |
30010 | MCC_OBSOLETE_30010 | ignore |
30011 | MCC_DEVICE_CHANGED | new DEVICE_CHANGE_INFO * (for internal use only) |
30012 | MCC_CONFIGURE_THEATER_VIEW | ignore |
30013 | MCC_SET_STATUSTEXT | wchar * pstrText (note: memory will be deleted by receiver) |
30014 | MCC_UPDATE_UI_AFTER_ACTIVE_WINDOW_CHANGE | ignore |
30015 | MCC_REENUM_PORTABLE_DEVICES | BOOL bDeviceConnected |
30016 | MCC_PLAY_ADVANCED | PLAY_COMMAND * pCommand (deleted by receiver) |
30017 | MCC_UPDATE_STATUS_BAR | ignore |
30018 | MCC_REQUEST_PODCAST_UPDATE | ignore |
30019 | MCC_REQUEST_PODCAST_PURGE | ignore |
30020 | MCC_AUDIBLE_ACTIVATE_PC | BOOL bActivate (TRUE: activate, FALSE: deactivate) |
30021 | MCC_SHOW_INVALID_CD_VOLUME_WARNING | TCHAR cDriveLetter |
Image Tools
Range: 31,000 to 32,000
Enum | Command | Parameter |
---|---|---|
31000 | MCC_IMAGE_SET_DESKTOP_BACK | ignore |
31001 | MCC_IMAGE_ROTATE_LEFT | ignore |
31002 | MCC_IMAGE_ROTATE_RIGHT | ignore |
31003 | MCC_IMAGE_ROTATE_UPSIDEDOWN | ignore |
31004 | MCC_IMAGE_RESIZE | ignore |
31005 | MCC_IMAGE_EDIT | ignore |
31006 | MCC_IMAGE_DELETE | int nFileKey |
31007 | MCC_IMAGE_PREVIEW_SHOW | ignore |
31008 | MCC_IMAGE_PREVIEW_HIDE | ignore |
31009 | MCC_IMAGE_LOCATE_ON_MAP | ignore |
Query
Range: 32,000 to 33,000
Enum | Command | Parameter |
---|---|---|
32000 | MCC_QUERY_UI_MODE | BOOL bInternalMode; Exit status is current UI mode: 0: Standard, 1: Mini, 2: Display, 3: Theater View, 4: Cover View |
Commands
Range: 33,000 to 34,000
Note: These are used internally; standard routing.
Enum | Command | Parameter |
---|---|---|
33000 | MCC_GET_SELECTED_FILES | loword: GET_SELECTION_MODES Mode, hiword: short nFlags (1: for playback) |
33001 | MCC_PRINTVIEW | ignore |
33002 | MCC_OUTPUT | int nPlaylistID (-1 for active view) |
33003 | MCC_SETFOCUS | ignore |
33004 | MCC_SELECT_FILES | CMediaArray * |
33005 | MCC_DOUBLE_CLICK | ignore |
33006 | MCC_PLAY_OR_SHOW | ignore |
33007 | MCC_SHOW_CURRENT_FILE | int nFlags (1: force, 2: select) |
33008 | MCC_BUY_SELECTED_TRACKS | int nPurchaseFlags |
33009 | MCC_BUY_ALL_TRACKS | int nPurchaseFlags |
33010 | MCC_BUY_ALBUM | int nPurchaseFlags |
33011 | MCC_UPDATE_AFTER_PLUGIN_INSTALLED | ignore |
33012 | MCC_UPDATE_AFTER_SKIN_INSTALLED | BOOL bMiniView |
Notifications
Range: 34,000 to 35,000
Note: These are used internally; routed to all view windows.
Enum | Command | Parameter |
---|---|---|
34000 | MCC_NOTIFY_FONT_CHANGED | ignore |
34001 | MCC_NOTIFY_VIEW_CHANGED | ignore |
34002 | MCC_NOTIFY_BEFORE_ACTIVE_VIEW_CHANGED | ignore |
34003 | MCC_NOTIFY_ACTIVE_VIEW_CHANGED | ignore |
34004 | MCC_NOTIFY_PLAYER_INFO_CHANGED | PLAYER_INFO_CHANGES nChange |
34005 | MCC_NOTIFY_TOOLTIPS_CHANGED | BOOL bEnabled |
34006 | MCC_NOTIFY_OPTIONS_CHANGED | ignore |
34007 | MCC_UPDATE | int nFlags |
34008 | MCC_NOTIFY_FOCUS_CHANGED | ignore |
34009 | MCC_SAVE_PROPERTIES | ignore |
34010 | MCC_NOTIFY_UI_MODE_CHANGED | UI_MODES NewMode |
34011 | MCC_NOTIFY_SELECTION_CHANGED | HWND hwndSource |
34012 | MCC_NOTIFY_FILE_CHANGED | int nFileKey (-1: invalidates all files) |
34013 | MCC_NOTIFY_FILE_STATUS_CHANGED | int nFileKey (-1: invalidates all files) |
34014 | MCC_NOTIFY_FILE_ENSURE_VISIBLE | int nFileKey |
34015 | MCC_NOTIFY_GET_TAB_HWNDS | ignore |
34016 | MCC_NOTIFY_BURNER_QUEUE_CHANGED | int nFlags (1: folder change) |
34017 | MCC_NOTIFY_BURNER_PROGRESS_CHANGED | int nPercentage |
34018 | MCC_NOTIFY_BURNER_STATUS_CHANGED | LPCTSTR pStatus |
34019 | MCC_NOTIFY_BURNER_STARTED | ignore |
34020 | MCC_NOTIFY_BURNER_FINISHED | ignore |
34021 | MCC_NOTIFY_BURNER_FAILED | LPCTSTR pError |
34022 | MCC_NOTIFY_BURNER_CLOSE_UI | ignore |
34023 | MCC_NOTIFY_BURNER_PREPARE_FOR_NEXT_COPY | LPCTSTR pStatus |
34024 | MCC_NOTIFY_RIP_STARTED | ignore |
34025 | MCC_NOTIFY_RIP_FINISHED | ignore |
34026 | MCC_NOTIFY_RIP_FAILED | LPCTSTR pError |
34027 | MCC_NOTIFY_RIP_PROGRESS_CHANGED | ignore |
34028 | MCC_NOTIFY_RIP_QUEUE_CHANGED | ignore |
34029 | MCC_NOTIFY_DVD_RIP_STARTED | ignore |
34030 | MCC_NOTIFY_DVD_RIP_FINISHED | ignore |
34031 | MCC_NOTIFY_DVD_RIP_FAILED | int nErrorCode |
34032 | MCC_NOTIFY_DVD_RIP_PROGRESS_CHANGED | int nPercent |
34033 | MCC_NOTIFY_DOWNLOAD_FINISHED | int nFileKey (-1: unknown) |
34034 | MCC_NOTIFY_DOWNLOAD_FAILED | int nFileKey (-1: unknown) |
34035 | MCC_NOTIFY_DOWNLOAD_STATUS_CHANGED | LPCTSTR pStatus |
34036 | MCC_NOTIFY_STATUS_CHECKER_COMPLETE | ignore |
34037 | MCC_NOTIFY_CURRENT_ZONE_CHANGED | ignore |
34038 | MCC_NOTIFY_DISPLAY_OWNER_CHANGED | HWND hwndOwner |
34039 | MCC_NOTIFY_AFTER_FIRST_UPDATE_LAYOUT_WINDOW | ignore |
34040 | MCC_NOTIFY_AFTER_FIRST_UPDATE_APPLY_VIEW_STATE | ignore |
34041 | MCC_NOTIFY_PROCESS_TIME_REMAINING | int nSecondsRemaining |
34042 | MCC_NOTIFY_UI_UPDATE_ENABLE_DISABLE_STATES | ignore |
34043 | MCC_NOTIFY_UI_SKIN_CHANGED | ignore |
34044 | MCC_UPDATE_WINDOW_LAYOUT | ignore |
34045 | MCC_NOTIFY_SAVE_UI_BEFORE_SHUTDOWN | ignore |
34046 | MCC_NOTIFY_UPDATE_CONTROL_BARS | ignore |
34047 | MCC_NOTIFY_PLAYLIST_FILES_CHANGED | int nPlaylistID |
34048 | MCC_NOTIFY_PLAYLIST_INFO_CHANGED | int nPlaylistID |
34049 | MCC_NOTIFY_PLAYLIST_ADDED_INTERNAL | int nPlaylistID |
34050 | MCC_NOTIFY_PLAYLIST_ADDED_BY_USER | int nPlaylistID |
34051 | MCC_NOTIFY_PLAYLIST_REMOVED | int nPlaylistID |
34052 | MCC_NOTIFY_PLAYLIST_COLLECTION_CHANGED | ignore |
34053 | MCC_NOTIFY_PLAYLIST_PROPERTIES_CHANGED | int nPlaylistID |
34054 | MCC_NOTIFY_HANDHELD_UPLOAD_STARTED | int nDeviceSessionID (0 gets default) |
34055 | MCC_NOTIFY_HANDHELD_AFTER_DEVICE_CHANGED | ignore |
34056 | MCC_NOTIFY_HANDHELD_QUEUE_CHANGED | ignore |
34057 | MCC_NOTIFY_HANDHELD_INFO_COMPLETE | ignore |
34058 | MCC_NOTIFY_HANDHELD_AFTER_UPLOAD_FINISHED | ignore |
34059 | MCC_NOTIFY_COMPACT_MEMORY | ignore |
34060 | MCC_NOTIFY_SEARCH_CHANGED | ignore |
34061 | MCC_NOTIFY_SEARCH_CONTEXT_CHANGED | ignore |
34062 | MCC_NOTIFY_UPDATE_SHOPPING_CART | JRStoreBase * pStore |
34063 | MCC_NOTIFY_UPDATE_NAVIGATION_TRAIL | ignore |
34064 | MCC_NOTIFY_IMPORT_STARTED | BOOL bSilent |
34065 | MCC_NOTIFY_IMPORT_FINISHED | BOOL bSilent |
34066 | MCC_NOTIFY_ROTATED_IMAGES | MFKEY nKey |
34067 | MCC_NOTIFY_LOGIN_STATE_CHANGE | BOOL bLoggedIn |
34068 | MCC_NOTIFY_MYGAL_PROGRESS | ignore |
34069 | MCC_NOTIFY_MYGAL_DONE | ignore |
34070 | MCC_NOTIFY_PODCAST_CHANGED | ignore |
34071 | MCC_NOTIFY_PODCAST_SETTINGS_CHANGED | ignore |
34072 | MCC_NOTIFY_CONVERT_PROGRESS | ignore |
34073 | MCC_NOTIFY_CONVERT_DONE | ignore |
34074 | MCC_NOTIFY_BREADCRUMBS_CHANGED | ignore |
34075 | MCC_NOTIFY_UI_LANGUAGE_CHANGED | ignore |
34076 | MCC_NOTIFY_INSTALLED_PLUGINS_CHANGED | ignore |
34077 | MCC_NOTIFY_SUGGESTED_MUSIC_CHANGED | ignore |
34078 | MCC_NOTIFY_VIEW_SETTINGS_CHANGED | int nFlags |
34079 | MCC_NOTIFY_BEFORE_CONFIGURE_VIEW_SETTINGS | ignore |
34080 | MCC_NOTIFY_TV_RECORDING_CHANGED | ignore |
34081 | MCC_NOTIFY_TV_PROGRAMMING_GUIDE_CHANGED | ignore |
34082 | MCC_NOTIFY_TV_CHANNELS_CHANGED | ignore |
34083 | MCC_NOTIFY_TV_RECORDING_STARTED | ignore |
34084 | MCC_NOTIFY_TV_RECORDING_FINISHED | ignore |
34085 | MCC_NOTIFY_IMPORT_FILES_ADDED | ignore |
34086 | MCC_NOTIFY_PLAYBACK_OPTIONS_CHANGED | ignore |
34087 | MCC_NOTIFY_BEFORE_LAYOUT_USER_INTERFACE | ignore |
34088 | MCC_NOTIFY_AFTER_LAYOUT_USER_INTERFACE | ignore |
34089 | MCC_NOTIFY_ZONE_ADDED_OR_REMOVED | int nZoneID (PLAYER_ZONE_ID_UNDEFINED means multiple changes) |
34090 | MCC_NOTIFY_ZONE_LINKED_OR_UNLINKED | ignore |
34091 | MCC_NOTIFY_LIBRARY_LOCATIONS_CHANGED | ignore |
34092 | MCC_NOTIFY_DSP_SETTINGS_CHANGED_IN_CODE | int nZoneID |
34093 | MCC_NOTIFY_OPTICAL_DISC_CHANGED | ignore |
Store
Range: 35,000 to 36,000
Enum | Command | Parameter |
---|---|---|
35000 | MCC_STORE_DOWNLOAD | BOOL bAllowPurchaseType |
35001 | MCC_STORE_PURCHASE | MFKEY nKey |
35002 | MCC_STORE_SEARCH_AMAZON | MFKEY nKey |
35003 | MCC_STORE_SEARCH_AMAZON_MP3_STORE | MFKEY nKey |
35004 | MCC_STORE_TSHIRT | MFKEY nKey |
Specifying Zones
Media Center Core Commands are targeted to a specific playback zone by combining the command's parameter value with the zone specifier value from the Zone Specifiers table. MC zones are integer indexes, from 0 to n, where 0 is the the first zone, 1 is the second zone, and so on. Zone indexes correspond to the zone order displayed under Playing Now in the Media Center tree. MC version 16.0.118 has simplified command line specification of parameter and zone, eliminating the need for manual calculations prior to usage. The /MCC option now accepts an alternate syntax in the format of [value]:[zone index] for the parameter (see examples). The text that follows documents and describes the original (and still valid) specification, which would be used when issuing an MCC command through a mechanism other than the MC16.exe command.
Zone | Decimal | Hexidecimal |
---|---|---|
Current | 0 | 0x00000000 |
0 | 16777216 | 0x01000000 |
1 | 33554432 | 0x02000000 |
2 | 50331648 | 0x03000000 |
3 | 67108864 | 0x04000000 |
4 | 83886080 | 0x05000000 |
5 | 100663296 | 0x06000000 |
... | ... | ... |
30 | 260046848 | 0x1F000000 |
31 | 520093696 | 0x20000000 |
Technically speaking, the command's parameter is OR'd with the zone specifier value, where bits 0 - 23 specify the command parameter, and bits 24 - 29 specify the zone. For command line usage, the final parameter value to pass to Media Center can be calculated as follows:
- If the parameter is >= 0, the final value = zone specifier + parameter
- If the parameter is < 0, the final value = zone specifier + parameter + 16777216
Examples
- Increase volume to 25% for Zone 2 (new parameter specification available starting with MC 16.0.118)
- MC16.exe /MCC 10020, 25:2
- Increase volume to 25% for Zone 2
- The MCC_VOLUME_SET command has command number 10020
- The desired parameter value is 25
- Zone 2 in the Zone Specifier table indicates a value of 50331648 (0x03000000 hex)
- Zone specifier (50331648) + parameter value (25) = 50331673 (0x3000019 hex)
- Toggle pause for Zone 3
- The MCC_SET_PAUSE command has command number 10022
- The desired parameter value is -1 (toggles)
- Zone 3 in the Zone Specifier table indicates a value of 67108864 (0x04000000 hex)
- Zone specifier (67108864) + parameter value (-1) + 16777216 = 83886079 (0x4FFFFFF hex)
Notes
- When bit 32 is set, the zone portion is ignored, and Media Center assumes the parameter is a negative number.
- See the C++ macros below for more information.
The look-up table below shows some pre-calculated parameter values for each of zones 0 through 5 for some typical commands. Find the desired operation, command and command number, and select the cell under the desired zone to obtain the final parameter value.
Operation | MCC Command | Command Number |
Parameter Value |
Zone 0 | Zone 1 | Zone 2 | Zone 3 | Zone 4 | Zone 5 |
---|---|---|---|---|---|---|---|---|---|
Play / Pause | MCC_PLAY_PAUSE | 10000 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Play track from start | MCC_PLAY | 10001 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Stop | MCC_STOP | 10002 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Next | MCC_NEXT | 10003 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Previous | MCC_PREVIOUS | 10004 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Toggle shuffle mode | MCC_SHUFFLE | 10005 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Shuffle - jump to PN | MCC_SHUFFLE | 10005 | 1 | 16777217 | 33554433 | 50331649 | 67108865 | 83886081 | 100663297 |
Shuffle - no jump to PN | MCC_SHUFFLE | 10005 | 2 | 16777218 | 33554434 | 50331650 | 67108866 | 83886082 | 100663298 |
Toggle continuous mode | MCC_CONTINUOUS | 10006 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
FF | MCC_FAST_FORWARD | 10008 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Rew | MCC_REWIND | 10009 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Play sequence # | MCC_PLAY_CPLDB_INDEX | 10015 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Mute | MCC_VOLUME_MUTE | 10017 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Vol +5 | MCC_VOLUME_UP | 10018 | 5 | 16777221 | 33554437 | 50331653 | 67108869 | 83886085 | 100663301 |
Vol -5 | MCC_VOLUME_DOWN | 10019 | 5 | 16777221 | 33554437 | 50331653 | 67108869 | 83886085 | 100663301 |
Vol 0 | MCC_VOLUME_SET | 10020 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Vol 25 | MCC_VOLUME_SET | 10020 | 25 | 16777241 | 33554457 | 50331673 | 67108889 | 83886105 | 100663321 |
Vol 50 | MCC_VOLUME_SET | 10020 | 50 | 16777266 | 33554482 | 50331698 | 67108914 | 83886130 | 100663346 |
Vol 75 | MCC_VOLUME_SET | 10020 | 75 | 16777291 | 33554507 | 50331723 | 67108939 | 83886155 | 100663371 |
Vol 100 | MCC_VOLUME_SET | 10020 | 100 | 16777316 | 33554532 | 50331748 | 67108964 | 83886180 | 100663396 |
Toggle pause | MCC_SET_PAUSE | 10022 | -1 | 33554431 | 50331647 | 67108863 | 83886079 | 100663295 | 117440511 |
Rating clear | MCC_SET_CURRENTLY_PLAYING_RATING | 10023 | 0 | 16777216 | 33554432 | 50331648 | 67108864 | 83886080 | 100663296 |
Rating 1 | MCC_SET_CURRENTLY_PLAYING_RATING | 10023 | 1 | 16777217 | 33554433 | 50331649 | 67108865 | 83886081 | 100663297 |
Rating 2 | MCC_SET_CURRENTLY_PLAYING_RATING | 10023 | 2 | 16777218 | 33554434 | 50331650 | 67108866 | 83886082 | 100663298 |
Rating 3 | MCC_SET_CURRENTLY_PLAYING_RATING | 10023 | 3 | 16777219 | 33554435 | 50331651 | 67108867 | 83886083 | 100663299 |
Rating 4 | MCC_SET_CURRENTLY_PLAYING_RATING | 10023 | 4 | 16777220 | 33554436 | 50331652 | 67108868 | 83886084 | 100663300 |
Rating 5 | MCC_SET_CURRENTLY_PLAYING_RATING | 10023 | 5 | 16777221 | 33554437 | 50331653 | 67108869 | 83886085 | 100663301 |
Other Defines
// the WM_APP based message (WM_APP = 32768, so WM_MC_COMMAND = 33768) #define WM_MC_COMMAND (WM_APP + 1000) // extended MC_COMMAND message that takes a structure with extra information (internal use only) #define WM_MC_COMMAND_EX (WM_APP + 1001) // return value for unhandled MCC commands #define MCC_UNHANDLED 0 // flags for command enable, disable, and check enum MCC_UPDATEUI_FLAGS { MCC_UPDATEUI_ENABLE = 1, MCC_UPDATEUI_DISABLE = 2, MCC_UPDATEUI_PRESSED = 4, };
Helper macros
#define IS_MCC_COMMAND_IN_RANGE(INDEX, FIRST, LAST) (((abs((int)INDEX)) >= FIRST) && ((abs((int)INDEX)) < LAST) || ((abs((int)INDEX)) >= FIRST + MCC_CUSTOMIZATION_OFFSET) && ((abs((int)INDEX)) < LAST + MCC_CUSTOMIZATION_OFFSET)) #define IS_MCC_COMMAND_IN_SECTION(INDEX, FIRST) IS_MCC_COMMAND_IN_RANGE(INDEX, FIRST, FIRST + 1000) #define IS_VALID_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_RANGE(INDEX, MCC_FIRST, MCC_LAST) #define IS_PLAYBACK_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_PLAYBACK_SECTION) #define IS_FILE_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_FILE_SECTION) #define IS_EDIT_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_EDIT_SECTION) #define IS_VIEW_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_VIEW_SECTION) #define IS_TOOL_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_TOOLS_SECTION) #define IS_HELP_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_HELP_SECTION) #define IS_TREE_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_TREE_SECTION) #define IS_LIST_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_LIST_SECTION) #define IS_SYSTEM_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_SYSTEM_SECTION) #define IS_PLAYBACK_ENGINE_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_PLAYBACK_ENGINE_SECTION) #define IS_IMAGE_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_IMAGE_SECTION) #define IS_QUERY_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_QUERY_SECTION) #define IS_INTERNAL_COMMAND_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_COMMANDS_SECTION) #define IS_NOTIFY_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_NOTIFICATIONS_SECTION) #define IS_CUSTOMIZATION_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_RANGE(INDEX, MCC_FIRST + MCC_CUSTOMIZATION_OFFSET, MCC_LAST + MCC_CUSTOMIZATION_OFFSET) #define MAKE_MCC_PLAYBACK_PARAM(PARAM, ZONE_INDEX) (((ZONE_INDEX) == -1) ? ((PARAM) & 0x00FFFFFF) : ((((ZONE_INDEX) + 1) << 24) & 0xFF000000) | ((PARAM) & 0x00FFFFFF)) #define GET_MCC_PLAYBACK_PARAM(PARAM) (((PARAM) & 0x400000) ? ((PARAM) & 0xFFFFFF) - 0x1000000 : ((PARAM) & 0xFFFFFF)) #define GET_MCC_PLAYBACK_ZONE_INDEX(PARAM) (((PARAM) & 0x80000000) ? -1 : (((PARAM) >> 24) - 1))
For Internal Use
// update flags #define MCC_UPDATE_FLAG_THUMBNAILS (1 << 0) #define MCC_UPDATE_FLAG_FILE_PROPERTIES (1 << 1) #define MCC_UPDATE_FLAG_FILE_ADDED_OR_REMOVED (1 << 2) #define MCC_UPDATE_FLAG_TREE_STRUCTURE (1 << 3) #define MCC_UPDATE_FLAG_REFILL_LIST (1 << 4) #define MCC_UPDATE_FLAG_ITEM_DELETED (1 << 5) #define MCC_UPDATE_FLAG_NO_PRESERVE_VIEW_STATE (1 << 6) #define MCC_UPDATE_FLAG_WEB_VIEW (1 << 7) // update all #define MCC_UPDATE_FLAG_ALL (0x7FFFFFFF & ~(MCC_UPDATE_FLAG_NO_PRESERVE_VIEW_STATE)) // settings changed flags #define MCC_SETTING_CHANGED_FLAG_UNKNOWN (1 << 0) #define MCC_SETTING_CHANGED_FLAG_COLUMNS (1 << 1) #define MCC_SETTING_CHANGED_FLAG_SORTING (1 << 2) #define MCC_SETTING_CHANGED_FLAG_VIEW_SCHEME (1 << 3) #define MCC_SETTING_CHANGED_FLAG_GROUPING (1 << 5) #define MCC_SETTING_CHANGED_FLAG_LIBRARY_VIEW_SETTINGS (1 << 6) // UI modes enum UI_MODES { // unknown UI_MODE_UNKNOWN = -2000, // internal modes UI_MODE_INTERNAL_NO_UI = -1000, UI_MODE_INTERNAL_STANDARD, UI_MODE_INTERNAL_MINI_FREEFORM, UI_MODE_INTERNAL_MINI_SLIM, UI_MODE_INTERNAL_DISPLAY_WINDOWED, UI_MODE_INTERNAL_DISPLAY_FULLSCREEN, UI_MODE_INTERNAL_THEATER, UI_MODE_INTERNAL_COVER, // toggles, shortcuts, etc. UI_MODE_SHORTCUT_TEMPORARY_DISPLAY_WINDOWED = -8, UI_MODE_SHORTCUT_TOGGLE_DISPLAY_AND_LAST_USER_INPUT_MODE = -7, UI_MODE_SHORTCUT_TOGGLE_DISPLAY_EXCLUDE_THEATER_VIEW = -6, UI_MODE_SHORTCUT_TOGGLE_DISPLAY = -5, UI_MODE_SHORTCUT_LAST_SHUTDOWN = -4, UI_MODE_SHORTCUT_CURRENT = -3, UI_MODE_SHORTCUT_CLOSE_DISPLAY = -2, UI_MODE_SHORTCUT_NEXT = -1, // modes presented to the user UI_MODE_STANDARD = 0, UI_MODE_MINI, UI_MODE_DISPLAY, UI_MODE_THEATER, UI_MODE_COVER, UI_MODE_COUNT, }; // player changes #define PLAYER_INFO_CHANGE_ALL 0xFFFF #define PLAYER_INFO_CHANGE_PLAYER_STATE (1 << 0) #define PLAYER_INFO_CHANGE_VOLUME (1 << 1) #define PLAYER_INFO_CHANGE_FILE_INFO (1 << 2) #define PLAYER_INFO_CHANGE_PLAYLIST (1 << 3) #define PLAYER_INFO_CHANGE_DSP (1 << 4) #define PLAYER_INFO_CHANGE_IMAGE (1 << 5) #define PLAYER_INFO_CHANGE_PLAYING_FILE (1 << 6) #define PLAYER_INFO_CHANGE_OUTPUT_INFO (1 << 7) // player status codes enum PLAYER_STATUS_CODES { PLAYER_STATUS_CODE_BUFFERING, PLAYER_STATUS_CODE_LOCATING, PLAYER_STATUS_CODE_CONNECTING, PLAYER_STATUS_CODE_DOWNLOADING_CODEC, PLAYER_STATUS_CODE_ACQUIRING_LICENSE, PLAYER_STATUS_CODE_INDIVIDUALIZE_STARTING, PLAYER_STATUS_CODE_INDIVIDUALIZE_CONNECTING, PLAYER_STATUS_CODE_INDIVIDUALIZE_REQUESTING, PLAYER_STATUS_CODE_INDIVIDUALIZE_RECEIVING, PLAYER_STATUS_CODE_INDIVIDUALIZE_COMPLETED, }; // theater view modes enum SHOW_THEATER_VIEW_MODES { SHOW_THEATER_VIEW_MODE_TOGGLE_THEATER_VIEW, SHOW_THEATER_VIEW_MODE_HOME, SHOW_THEATER_VIEW_MODE_PLAYING_NOW, SHOW_THEATER_VIEW_MODE_AUDIO, SHOW_THEATER_VIEW_MODE_IMAGES, SHOW_THEATER_VIEW_MODE_VIDEOS, SHOW_THEATER_VIEW_MODE_PLAYLISTS, SHOW_THEATER_VIEW_MODE_CD_DVD, SHOW_THEATER_VIEW_MODE_TELEVISION, SHOW_THEATER_VIEW_MODE_TELEVISION_GUIDE, SHOW_THEATER_VIEW_MODE_TELEVISION_RECORDINGS, SHOW_THEATER_VIEW_MODE_LAST_VIEWED, }; // get selection modes enum GET_SELECTION_MODES { GET_SELECTION_EXACT, GET_SELECTION_ALL_ON_NONE, GET_SELECTION_ALL_ON_ONE_OR_NONE, GET_SELECTION_ALL, GET_SELECTION_EXACT_WITH_POSITION, };