windows-nt/Source/XPSP1/NT/multimedia/media/winmm/mciparse.c

1956 lines
58 KiB
C
Raw Normal View History

2020-09-26 03:20:57 -05:00
/*******************************Module*Header*********************************\
* Module Name: mciparse.c
*
* Media Control Architecture Command Parser
*
* Created: 3/2/90
* Author: DLL (DavidLe)
*
* History:
* 5/22/91: Ported to Win32 - NigelT
* 4 Mar 1992: SteveDav - much work for NT. Bring up to Win 3.1 level
*
* Copyright (c) 1991-1998 Microsoft Corporation
*
\******************************************************************************/
//****************************************************************************
//
// This has to be defined in order to pick up the
// correct version of MAKEINTRESOURCE
//
//****************************************************************************
#define UNICODE
/*****************************************************************************
* Notes: *
* *
* MCI command tables are (normally) loaded from resource type files. The *
* format of a command table is shown below. Note that because the table *
* contains string data, the binary values are UNALIGNED. This causes *
* specific problems on MIPS machines. *
* *
* Because of compatibility with Windows 3.1 the binary data is WORD size *
* *
* Table format: *
* *
* verb\0 MCI_MESSAGE,0 MCI_command_type *
* *
* e.g. *
* 'o' 'p' 'e' 'n' 03 08 00 00 00 'n' 'o' 't' 'i' 'f' 'y' 00 *
* 01 00 00 00 00 05 00 *
* *
* which is "open" MCI_OPEN,0, MCI_COMMAND_HEAD *
* "notify" MCI_NOTIFY,0 MCI_FLAG *
* *
* beware of the byte ordering! *
* *
****************************************************************************/
#include "winmmi.h"
#include "mci.h"
#include "wchar.h"
#include <digitalv.h>
#define _INC_WOW_CONVERSIONS
#include "mmwow32.h"
extern WSZCODE wszOpen[]; // in MCI.C
STATICFN UINT mciRegisterCommandTable( HANDLE hResource, PUINT lpwIndex,
UINT wType, HANDLE hModule);
STATICFN UINT mciParseArgument ( UINT uMessage, DWORD dwValue, UINT wID,
LPWSTR FAR *lplpstrOutput, LPDWORD lpdwFlags, LPWSTR lpArgument,
LPWSTR lpCurrentCommandItem);
//
// Define the init code for this file. This is commented out in debug builds
// so that codeview doesn't get confused.
#if DBG
extern int mciDebugLevel;
#endif
// Number of command tables registered, including "holes"
STATICDT UINT number_of_command_tables = 0;
// Command table list
COMMAND_TABLE_TYPE command_tables[MAX_COMMAND_TABLES];
STATICDT WSZCODE wszTypeTableExtension[] = L".mci";
STATICDT WSZCODE wszCoreTable[] = L"core";
// Core table is loaded when the first MCI command table is requested
STATICDT BOOL bCoreTableLoaded = FALSE;
// One element for each device type. Value is the table type to use
// or 0 if there is no device type specific table.
STATICDT UINT table_types[] =
{
MCI_DEVTYPE_VCR, // vcr
MCI_DEVTYPE_VIDEODISC, // videodisc
MCI_DEVTYPE_OVERLAY, // overlay
MCI_DEVTYPE_CD_AUDIO, // cdaudio
MCI_DEVTYPE_DAT, // dat
MCI_DEVTYPE_SCANNER, // scanner
MCI_DEVTYPE_ANIMATION, // animation
MCI_DEVTYPE_DIGITAL_VIDEO, // digitalvideo
MCI_DEVTYPE_OTHER, // other
MCI_DEVTYPE_WAVEFORM_AUDIO, // waveaudio
MCI_DEVTYPE_SEQUENCER // sequencer
};
/*
* @doc INTERNAL MCI
* @func UINT | mciEatCommandEntry | Read a command resource entry and
* return its length and its value and identifier
*
* @parm LPWCSTR | lpEntry | The start of the command resource entry
*
* @parm LPDWORD | lpValue | The value of the entry, returned to caller
* May be NULL
*
* @parm PUINT | lpID | The identifier of the entry, returned to caller
* May be NULL
*
* @rdesc The total number of bytes in the entry
*
*/
UINT mciEatCommandEntry (
LPCWSTR lpEntry,
LPDWORD lpValue,
PUINT lpID)
{
LPCWSTR lpScan = lpEntry;
LPBYTE lpByte;
#if DBG
DWORD Value;
UINT Id;
#endif
// NOTE: The data will generally be UNALIGNED
/* Skip to end */
while (*lpScan++ != '\0'){}
/* lpScan now points at the byte beyond the terminating zero */
lpByte = (LPBYTE)lpScan;
if (lpValue != NULL) {
*lpValue = *(UNALIGNED DWORD *)lpScan;
}
#if DBG
Value = *(UNALIGNED DWORD *)lpScan;
#endif
lpByte += sizeof(DWORD);
if (lpID != NULL) {
*lpID = *(UNALIGNED WORD *)lpByte;
}
#if DBG
Id = *(UNALIGNED WORD *)lpByte;
#endif
lpByte += sizeof(WORD);
//
// WARNING !! This assumes that the table being looked at has WORD
// size entries in the RCDATA resource
//
#if DBG
dprintf5(("mciEatCommandEntry(%ls) Value: %x Id: %x", lpEntry, Value, Id));
#endif
return (UINT)(lpByte - (LPBYTE)lpEntry); // Total size of entry in bytes
}
//
// Return the size used by this token in the parameter list
//
UINT mciGetParamSize (
DWORD dwValue,
UINT wID)
{
// MCI_RETURN returns 8 for sizeof(STRING) as there is a length
// field as well as the string pointer. For non MCI_RETURN uses
// of MCI_STRING we should return 4 (== sizeof pointer)
// Similarly, MCI_CONSTANT used within MCI_RETURN is size 0, but
// size 4 when used as an input parameter.
if (wID == MCI_RETURN) {
if (dwValue==MCI_STRING) {
return(8);
} else if (dwValue==MCI_CONSTANT) {
wID = 0;
} else {
wID=dwValue;
}
}
switch (wID)
{
case MCI_CONSTANT:
case MCI_INTEGER:
case MCI_STRING:
case MCI_HWND:
case MCI_HPAL:
case MCI_HDC:
return sizeof(DWORD_PTR); // In Win64, sizeof pointer is 8
case MCI_RECT:
return sizeof(RECT);
}
// Note that some items will not be found - deliberately. For example
// MCI_FLAG causes 0 to be returned.
return 0;
}
/*
* @doc INTERNAL MCI
* @func UINT | mciRegisterCommandTable | This function adds a new
* table for the MCI parser.
*
* @parm HANDLE | hResource | Handle to the RCDATA resource
*
* @parm PUINT | lpwIndex | Pointer to command table index
*
* @parm UINT | wType | Specifies the device type for this command table.
* Driver tables and the core table are type 0.
*
* @rdesc Returns the command table index number that was assigned or MCI_ERROR_VALUE
* on error.
*
*/
STATICFN UINT mciRegisterCommandTable (
HANDLE hResource,
PUINT lpwIndex,
UINT wType,
HANDLE hModule)
{
UINT uID;
/* First check for free slots */
mciEnter("mciRegisterCommandTable");
for (uID = 0; uID < number_of_command_tables; ++uID) {
if (command_tables[uID].hResource == NULL) {
break;
}
}
/* If no empty slots then allocate another one */
if (uID >= number_of_command_tables)
{
if (number_of_command_tables == MAX_COMMAND_TABLES)
{
dprintf1(("mciRegisterCommandTable: No more tables"));
mciFree(lpwIndex); // Cannot use it - must free it
mciLeave("mciRegisterCommandTable");
return (UINT)MCI_ERROR_VALUE;
} else {
uID = number_of_command_tables++;
// The table goes at the end of the list
}
}
/* Fill in the slot */
command_tables[uID].wType = wType;
command_tables[uID].hResource = hResource;
command_tables[uID].lpwIndex = lpwIndex;
command_tables[uID].hModule = hModule;
#if DBG
command_tables[uID].wLockCount = 0;
#endif
// now that hResource has been filled in marking the entry as used
// we can allow others access.
mciLeave("mciRegisterCommandTable");
#if DBG
if (mciDebugLevel > 2)
{
dprintf2(("mciRegisterCommandTable INFO: assigned slot %d", uID));
dprintf2(("mciRegisterCommandTable INFO: #tables is %d", number_of_command_tables));
}
#endif
return uID;
}
/*
* @doc DDK MCI
* @api UINT | mciLoadCommandResource | Registers the indicated
* resource as an MCI command table and builds a command table
* index. If a file with the resource name and the extension '.mci' is
* found in the path then the resource is taken from that file.
*
* @parm HANDLE | hInstance | The instance of the module whose executable
* file contains the resource. This parameter is ignored if an external file
* is found.
*
* @parm LPCWSTR | lpResName | The name of the resource
*
* @parm UINT | wType | The table type. Custom device specific tables MUST
* give a table type of 0.
*
* @rdesc Returns the command table index number that was assigned or MCI_ERROR_VALUE
* on error.
*
*/
UINT mciLoadCommandResource (
HANDLE hInstance,
LPCWSTR lpResName,
UINT wType)
{
BOOL fResType = !HIWORD(lpResName);
PUINT lpwIndex, lpwScan;
HANDLE hExternal = NULL;
HANDLE hResource;
HANDLE hResInfo;
LPWSTR lpResource, lpScan;
int nCommands = 0;
UINT wLen;
UINT wID;
// Name + '.' + Extension + '\0'
WCHAR strFile[8 + 1 + 3 + 1];
LPWSTR lpstrFile = strFile;
LPCWSTR lpstrType = lpResName;
#if DBG
if (!fResType) {
dprintf3(("mciLoadCommandResource INFO: Resource name >%ls< ", (LPWSTR)lpResName));
} else if (LOWORD(lpResName)) {
dprintf3(("mciLoadCommandResource INFO: Resource ID >%d<", (UINT)LOWORD(lpResName)));
} else {
dprintf3(("mciLoadCommandResource INFO: NULL resource pointer"));
}
#endif
// Initialize the device list
if (!MCI_bDeviceListInitialized && !mciInitDeviceList()) {
return (UINT)MCI_ERROR_VALUE; // MCIERR_OUT_OF_MEMORY;
}
// Load the core table if its not already there
if (!bCoreTableLoaded)
{
bCoreTableLoaded = TRUE;
// Now we can call ourselves recursively to first load the core
// table. Check if this is a request to load CORE - if yes,
// simply drop through.
// If its not our core table being loaded...
// which is decided by comparing the string with CORE, or if a
// resource id has been given, the resource id is ID_CORE and comes
// from our module
// The test is structured this way so that lstrcmpiW is only called
// if we have a valid pointer.
#define fNotCoreTable ( fResType \
? ((hInstance != ghInst) || (ID_CORE_TABLE != (UINT)(UINT_PTR)lpResName)) \
: (0 != lstrcmpiW (wszCoreTable, (LPWSTR)lpResName)))
if (fNotCoreTable) {
// We are not being asked to load the core table. So we
// explicitly load the core table first
if (mciLoadCommandResource (ghInst, MAKEINTRESOURCE(ID_CORE_TABLE), 0) == MCI_ERROR_VALUE)
{
dprintf1(("mciLoadCommandResource: Cannot load core table"));
}
}
}
// Unless this is a resource ID, go and look for a file
if (!fResType) {
WCHAR ExpandedName[MAX_PATH];
LPWSTR FilePart;
// Check for a file with the extension ".mci"
// Copy up to the first eight characters of device type
// !!LATER!! Try a check for a resource first, then a file
while (lpstrType < lpResName + 8 && *lpstrType != '\0') {
*lpstrFile++ = *lpstrType++;
}
// Tack extension onto end
wcscpy (lpstrFile, wszTypeTableExtension);
// If the file exists and can be loaded then set flag to use it.
// (Otherwise we will try and load the resource from WINMM.DLL.)
if (!SearchPathW(NULL, strFile, NULL, MAX_PATH, ExpandedName,
&FilePart)) {
hExternal = NULL;
} else {
UINT OldErrorMode;
OldErrorMode = SetErrorMode(SEM_FAILCRITICALERRORS);
// Use "ExpandedName" to prevent a second search taking place
hExternal = LoadLibraryExW( ExpandedName, //strFile,
NULL,
DONT_RESOLVE_DLL_REFERENCES);
SetErrorMode(OldErrorMode);
}
}
// Load the given table from the file or from the module if not found
if (hExternal != NULL &&
(hResInfo = FindResourceW(hExternal, lpResName, RT_RCDATA )) != NULL)
{
hInstance = hExternal;
} else {
hResInfo = FindResourceW(hInstance, lpResName, RT_RCDATA );
}
if (hResInfo == NULL)
{
#if DBG
if (!fResType) {
dprintf3(("mciLoadCommandResource Cannot find command resource name >%ls< ", (LPWSTR)lpResName));
} else {
dprintf3(("mciLoadCommandResource Cannot find command resource ID >%d<", (UINT)LOWORD(lpResName)));
}
#endif
if (NULL != hExternal) {
FreeLibrary(hExternal); // Clean up after ourselves
}
return (UINT)MCI_ERROR_VALUE;
}
if ((hResource = LoadResource (hInstance, hResInfo)) == NULL)
{
#if DBG
if (!fResType) {
dprintf3(("mciLoadCommandResource Cannot load command resource name >%ls< ", (LPWSTR)lpResName));
} else {
dprintf3(("mciLoadCommandResource Cannot load command resource ID >%d<", (UINT)LOWORD(lpResName)));
}
#endif
if (NULL != hExternal) {
FreeLibrary(hExternal); // Clean up after ourselves
}
return (UINT)MCI_ERROR_VALUE;
}
if ((lpResource = LockResource (hResource)) == NULL)
{
dprintf1(("mciLoadCommandResource: Cannot lock resource"));
FreeResource (hResource);
if (NULL != hExternal) {
FreeLibrary(hExternal); // Clean up after ourselves
}
return (UINT)MCI_ERROR_VALUE;
}
/* Count the number of commands */
lpScan = lpResource;
while (TRUE)
{
(LPBYTE)lpScan = (LPBYTE)lpScan + mciEatCommandEntry(lpScan, NULL, &wID);
// End of command?
if (wID == MCI_COMMAND_HEAD)
++nCommands;
// End of command list?
else if (wID == MCI_END_COMMAND_LIST)
break;
}
// There must be at least one command in the table
if (nCommands == 0)
{
dprintf1(("mciLoadCommandResource: No commands in the specified table"));
UnlockResource (hResource);
FreeResource (hResource);
if (NULL != hExternal) {
FreeLibrary(hExternal); // Clean up after ourselves
}
return (UINT)MCI_ERROR_VALUE;
} else {
dprintf3(("mciLoadCommandResource: %d commands in the specified table", nCommands));
}
// Allocate storage for the command table index
// Leave room for a MCI_TABLE_NOT_PRESENT entry to terminate it
if ((lpwIndex = mciAlloc (sizeof (*lpwIndex) * (nCommands + 1)))
== NULL)
{
dprintf1(("mciLoadCommandResource: cannot allocate command table index"));
UnlockResource (hResource);
FreeResource (hResource);
if (NULL != hExternal) {
FreeLibrary(hExternal); // Clean up after ourselves
}
return (UINT)MCI_ERROR_VALUE;
}
/* Build Command Table */
lpwScan = lpwIndex;
lpScan = lpResource;
while (TRUE)
{
// Get next command entry
wLen = mciEatCommandEntry (lpScan, NULL, &wID);
if (wID == MCI_COMMAND_HEAD)
{
// Add an offset index to this command from start of resource
*lpwScan++ = (UINT)((LPBYTE)lpScan - (LPBYTE)lpResource);
}
else if (wID == MCI_END_COMMAND_LIST)
{
// Mark the end of the table
*lpwScan = (UINT)MCI_TABLE_NOT_PRESENT;
break;
}
(LPBYTE)lpScan = (LPBYTE)lpScan + wLen;
}
UnlockResource (hResource);
return mciRegisterCommandTable (hResource, lpwIndex, wType, hExternal);
}
/*
* @doc INTERNAL MCI
* @func UINT | mciLoadTableType | If the table of the given type
* has not been loaded, register it
*
* @parm UINT | wType | The table type to load
*
* @rdesc Returns the command table index number that was assigned or MCI_ERROR_VALUE
* on error.
*/
UINT mciLoadTableType (
UINT wType)
{
UINT wID;
#ifdef OLD
WCHAR buf[MCI_MAX_DEVICE_TYPE_LENGTH];
#endif
// Check to see if this table type is already loaded
for (wID = 0; wID < number_of_command_tables; ++wID) {
if (command_tables[wID].wType == wType) {
return wID;
}
}
// Must load table
// First look up what device type specific table to load for this type
if (wType < MCI_DEVTYPE_FIRST || wType > MCI_DEVTYPE_LAST) {
return (UINT)MCI_ERROR_VALUE;
}
// Load string that corresponds to table type
#ifdef OLD
#ifdef WIN31CODE
// Load string that corresponds to table type
buf[0] = 0; // In case load string fails to set anything
LoadString (ghInst, table_types[wType - MCI_DEVTYPE_FIRST],
buf, sizeof(buf));
{
//Must be at least one character in type name
int nTypeLen;
if ((nTypeLen = wcslen (buf)) < 1)
return MCI_ERROR_VALUE;
}
#else
// Load string that corresponds to table type
buf[0] = 0; // In case load string fails to set anything
if (!LoadString (ghInst, table_types[wType - MCI_DEVTYPE_FIRST],
buf, sizeof(buf))) {
//Must put at least one character into type name
return MCI_ERROR_VALUE;
}
#endif // WIN31CODE
// Register the table with MCI
return mciLoadCommandResource (ghInst, buf, wType);
#else // not old
// Command tables are stored as RCDATA blocks with an id of the device type
// If mciLoadCommandResource fails to find the command table then it
// will return MCI_ERROR_VALUE
//if (!FindResource(ghInst, wType, RT_RCDATA))
// return MCI_ERROR_VALUE;
//
// Register the table with MCI
return mciLoadCommandResource (ghInst, MAKEINTRESOURCE(wType), wType);
#endif
}
/*
* @doc DDK MCI
*
* @api BOOL | mciFreeCommandResource | Frees the memory used
* by the specified command table.
*
* @parm UINT | wTable | The table index returned from a previous call to
* mciLoadCommandResource.
*
* @rdesc FALSE if the table index is not valid, TRUE otherwise.
*
*/
BOOL APIENTRY mciFreeCommandResource (
UINT wTable)
{
MCIDEVICEID wID;
HANDLE hResource;
PUINT lpwIndex;
dprintf3(("mciFreeCommandResource INFO: Free table %d", wTable));
dprintf3(("mciFreeCommandResource INFO: Lockcount is %d", command_tables[wTable].wLockCount));
/* Validate input -- do not let the core table be free'd */
if (wTable == MCI_TABLE_NOT_PRESENT || wTable >= number_of_command_tables)
{
#if DBG
// wTable == MCI_TABLE_NOT_PRESENT is OK
if (wTable != MCI_TABLE_NOT_PRESENT) {
dprintf1(("mciFreeCommandResource: Cannot free table number %d", wTable));
}
#endif
return FALSE;
}
mciEnter("mciFreeCommandResource");
// If this table is being used elsewhere then keep it around
for (wID = 1; wID < MCI_wNextDeviceID; ++wID)
{
if (MCI_lpDeviceList[wID] != NULL)
{
if (MCI_lpDeviceList[wID]->wCustomCommandTable == wTable ||
MCI_lpDeviceList[wID]->wCommandTable == wTable)
{
#if DBG
if (mciDebugLevel > 2) {
dprintf1(("mciFreeCommandResource INFO: table in use"));
}
#endif
mciLeave("mciFreeCommandResource");
return FALSE;
}
}
}
#if 0
/* Search the list of tables */
for (wID = 0; wID < number_of_command_tables; ++wID)
/* If this resource is still in use, keep it around */
if (command_tables[wID].hResource == hResource)
{
#if DBG
if (mciDebugLevel > 2)
DOUT(("mciFreeCommandResource INFO: resource in use\r\n"));
#endif
mciLeave("mciFreeCommandResource");
return FALSE;
}
#endif
hResource = command_tables[wTable].hResource;
command_tables[wTable].hResource = NULL;
// This slot can now be picked up by someone else
lpwIndex = command_tables[wTable].lpwIndex;
command_tables[wTable].lpwIndex = NULL;
command_tables[wTable].wType = 0;
FreeResource (hResource);
mciFree (lpwIndex);
hResource = command_tables[wTable].hModule;
mciLeave("mciFreeCommandResource");
if (hResource != NULL)
{
FreeLibrary (hResource);
}
// Make space at top of list
if (wTable == number_of_command_tables - 1)
{
--number_of_command_tables;
}
dprintf3(("mciFreeCommandResource INFO: number_of_command_tables: %d", number_of_command_tables));
return TRUE;
}
#if DBG
void mciCheckLocks ()
{
UINT wTable;
if (mciDebugLevel <= 2) {
return;
}
for (wTable = 0; wTable < number_of_command_tables; ++wTable)
{
if (command_tables[wTable].hResource == NULL) {
continue;
}
dprintf2(("mciCheckLocks INFO: table %d Lock count %d", wTable, command_tables[wTable].wLockCount));
// dprintf2(("user: %x ", GlobalFlags (command_tables[wTable].hResource) & GMEM_LOCKCOUNT));
//
// if (GlobalFlags (command_tables[wTable].hResource) & GMEM_DISCARDABLE) {
// dprintf(("discardable"));
// } else {
// dprintf(("NOT discardable"));
// }
}
}
#endif
/*
* @doc INTERNAL MCI
* @func BOOL | mciUnlockCommandTable | Unlocks the command table given by
* a table index
*
* @parm UINT | wCommandTable | Table to unlock
*
* @rdesc TRUE if success, FALSE otherwise
*
* @comm Used external to this module by mci.c
*
*/
BOOL mciUnlockCommandTable (
UINT wCommandTable)
{
UnlockResource(command_tables[wCommandTable].hResource);
#if DBG
--command_tables[wCommandTable].wLockCount;
if (mciDebugLevel > 2)
{
dprintf2(("mciUnlockCommandTable INFO: table %d", wCommandTable));
mciCheckLocks();
}
#endif
return TRUE;
}
/*
* @doc INTERNAL MCI
* @func LPWSTR | FindCommandInTable | Look up the given
* command string in the GIVEN parser command table
*
* @parm UINT | wTable | Command table to use
*
* @parm LPCWSTR | lpstrCommand | The command to look up. It must
* be in lower case with no leading or trailing blanks and with at
* least one character.
*
* @parm PUINT | lpwMessage | The message corresponding to the command
* Returned to caller.
*
* @rdesc NULL if the command is unknown or on error, otherwise a pointer to
* the command list ffr the input command string.
*
* @comm If the command is found, the command resource will be locked on exit.
*
*/
LPWSTR FindCommandInTable (
UINT wTable,
LPCWSTR lpstrCommand,
PUINT lpwMessage)
{
PUINT lpwIndex;
LPWSTR lpResource, lpstrThisCommand;
UINT wMessage;
#if DBG
if (HIWORD(lpstrCommand)) {
dprintf3(("FindCommandInTable(%04XH, %ls)", wTable, lpstrCommand));
} else {
dprintf3(("FindCommandInTable(%04XH, id = %x)", wTable, (UINT)LOWORD(lpstrCommand)));
}
#endif
//
/* Validate table */
//
mciEnter("FindCommandInTable");
if (wTable >= number_of_command_tables)
{
//
// Check the core table but its not yet loaded
//
if (wTable == 0)
{
//
// Try to load it
//
// if (mciLoadCommandResource (ghInst, wszCoreTable, 0) == MCI_ERROR_VALUE)
if (mciLoadCommandResource (ghInst, (LPCWSTR)ID_CORE_TABLE, 0) == MCI_ERROR_VALUE)
{
mciLeave("FindCommandInTable");
dprintf1(("FindCommandInTable: cannot load core table"));
return NULL;
}
}
else
{
mciLeave("FindCommandInTable");
dprintf1(("FindCommandInTable: invalid table ID: %04XH", wTable));
return NULL;
}
}
if ((lpResource = LockResource (command_tables[wTable].hResource)) == NULL)
{
mciLeave("FindCommandInTable");
dprintf1(("MCI FindCommandInTable: Cannot lock table resource"));
return NULL;
}
#if DBG
++command_tables[wTable].wLockCount;
#endif
//
// Look at each command in the table
// We use the index table rather than the return value from
// mciEatCommandEntry to step through the table
//
lpwIndex = command_tables[wTable].lpwIndex;
if (lpwIndex == NULL)
{
mciLeave("FindCommandInTable");
dprintf1(("MCI FindCommandInTable: null command table index"));
return NULL;
}
while (*lpwIndex != MCI_TABLE_NOT_PRESENT)
{
lpstrThisCommand = (LPWSTR)(*lpwIndex++ + (LPBYTE)lpResource);
//
// Get message number from the table
//
mciEatCommandEntry ((LPCWSTR)lpstrThisCommand, (LPDWORD)&wMessage, NULL);
//
// Does this command match the input?
// IF we have a string pointer, check the command name matches,
// OR for a message, check the message values match
//
if (HIWORD (lpstrCommand) != 0 &&
lstrcmpiW(lpstrThisCommand, lpstrCommand) == 0 ||
HIWORD (lpstrCommand) == 0 &&
wMessage == (UINT)LOWORD(PtrToUlong(lpstrCommand)))
{
//
// Retain the locked resource pointer
//
command_tables[wTable].lpResource = lpResource;
//
// Address the message ID which comes after the command name
//
if (lpwMessage != NULL) *lpwMessage = wMessage;
//
// Leave table locked on exit
//
mciLeave("FindCommandInTable");
dprintf3(("mciFindCommandInTable: found >%ls< Message %x", lpstrThisCommand, wMessage));
return lpstrThisCommand;
}
//
// Strings don't match, go to the next command in the table
//
}
UnlockResource (command_tables[wTable].hResource);
#if DBG
--command_tables[wTable].wLockCount;
#endif
mciLeave("FindCommandInTable");
dprintf3((" ...not found"));
return NULL;
}
/*
* @doc INTERNAL MCI
* @func LPWSTR | FindCommandItem | Look up the given
* command string in the parser command tables
*
* @parm MCIDEVICEID | wDeviceID | The device ID used for this command.
* If 0 then only the system core command table is searched.
*
* @parm LPCWSTR | lpstrType | The type name of the device
*
* @parm LPCWSTR | lpstrCommand | The command to look up. It must
* be in lower case with no leading or trailing blanks and with at
* least one character. If the HIWORD is 0 then the LOWORD contains
* the command message ID instead of a command name and the function is
* merely to find the command list pointer.
*
* If the high word is 0 then the low word is an command ID value instead
* of a command name
*
* @parm PUINT | lpwMessage | The message corresponding to the command
* Returned to caller.
*
* @parm LPUINT | lpwTable | The table index in which the command was found
* Returned to caller.
*
* @rdesc NULL if the command is unknown, otherwise a pointer to
* the command list for the input command string.
*/
LPWSTR FindCommandItem (
MCIDEVICEID wDeviceID,
LPCWSTR lpstrType,
LPCWSTR lpstrCommand,
PUINT lpwMessage,
PUINT lpwTable)
{
LPWSTR lpCommand = NULL;
UINT wTable;
LPMCI_DEVICE_NODE nodeWorking;
UINT uDeviceType = 0;
UNREFERENCED_PARAMETER(lpstrType);
//
// Only check hiword per comments above
//
if (HIWORD (lpstrCommand) != (WORD)NULL) {
if (*lpstrCommand == '\0')
{
dprintf1(("MCI FindCommandItem: lpstrCommand is NULL or empty string"));
return NULL;
} else {
dprintf3(("FindCommandItem(%ls)", lpstrCommand));
}
} else {
dprintf3(("FindCommandItem(command id = %x)", (UINT)LOWORD(lpstrCommand)));
}
//
// If a specific device ID was specified then look in any custom table
// or type table
//
if (wDeviceID != 0 && wDeviceID != MCI_ALL_DEVICE_ID)
{
//
// If the device ID is valid
//
mciEnter("FindCommandItem");
if (!MCI_VALID_DEVICE_ID (wDeviceID) ||
(NULL == (nodeWorking = MCI_lpDeviceList[wDeviceID])))
{
dprintf1(("MCI FindCommandItem: Invalid device ID or pointer"));
mciLeave("FindCommandItem");
return NULL;
}
uDeviceType = nodeWorking->wDeviceType;
//
// If there is a custom command table then use it
//
if ((wTable = nodeWorking->wCustomCommandTable) != MCI_TABLE_NOT_PRESENT)
{
lpCommand = FindCommandInTable (wTable, lpstrCommand, lpwMessage);
if (lpCommand != NULL) {
mciLeave("FindCommandItem");
goto exit;
}
}
//
// Get the device type table from the existing device
// Relies on mciReparseCommand in mciLoadDevice to catch all device type
// tables when device is not yet open.
//
if ((wTable = nodeWorking->wCommandTable) != MCI_TABLE_NOT_PRESENT)
{
lpCommand = FindCommandInTable (wTable, lpstrCommand, lpwMessage);
if (lpCommand != NULL) {
mciLeave("FindCommandItem");
goto exit;
}
}
mciLeave("FindCommandItem");
}
#if 0
// If no device was specified
if (uDeviceType == 0 && lpstrType != NULL && *lpstrType != '\0')
{
// See if the type is one known
uDeviceType = mciLookUpType (lpstrType);
if (uDeviceType == 0)
{
// Otherwise see if the type is an element with a known extension
WCHAR strTemp[MCI_MAX_DEVICE_NAME_LENGTH];
if (mciExtractDeviceType (lpstrType, strTemp, sizeof(strTemp)))
uDeviceType = mciLookUpType (strTemp);
}
}
/*
If the command was not found in the custom table look in the type specific
table
*/
if (uDeviceType != 0)
{
wTable = mciLoadTableType (uDeviceType);
if (wTable != MCI_TABLE_NOT_PRESENT)
{
lpCommand = FindCommandInTable (wTable, lpstrCommand, lpwMessage);
if (lpCommand != NULL) {
goto exit;
}
}
}
#endif
//
// If no match was found in the device or type specific tables
// Look in the core table
//
wTable = 0;
lpCommand = FindCommandInTable (wTable, lpstrCommand, lpwMessage);
if (lpCommand == NULL) {
wTable = (UINT)MCI_TABLE_NOT_PRESENT;
}
exit:;
if (lpwTable != NULL) {
*lpwTable = wTable;
}
#if DBG
if (mciDebugLevel > 2)
{
dprintf2(("FindCommandItem INFO: check locks..."));
mciCheckLocks();
}
#endif
#if DBG
dprintf3((" found: %ls in table %d", lpCommand ? lpCommand : L"(NULL)", wTable));
#endif
return lpCommand;
}
/*
* @doc INTERNAL MCI
* @func LPWSTR | mciCheckToken | Check to see if the command item matches
* the given string, allowing multiple blanks in the input parameter to
* match a corresponding single blank in the command token and ignoring
* case.
*
* @parm LPCWSTR | lpstrToken | The command token to check
*
* @parm LPCWSTR | lpstrParam | The input parameter
*
* @rdesc NULL if no match, otherwise points to the first character
* after the parameter
*
*/
STATICFN LPWSTR mciCheckToken (
LPCWSTR lpstrToken,
LPCWSTR lpstrParam)
{
/* Check for legal input */
if (lpstrToken == NULL || lpstrParam == NULL) {
return NULL;
}
while (*lpstrToken != '\0' && MCI_TOLOWER(*lpstrParam) == *lpstrToken)
{
// If the token contains a blank, allow more than one blank in the
// parameter. If the next character is a blank, skip to the next
// non-blank.
if (*lpstrToken == ' ') {
while (*lpstrParam == ' ') {
++lpstrParam;
}
} else {
lpstrParam++;
}
lpstrToken++;
}
if (*lpstrToken != '\0'|| (*lpstrParam != '\0' && *lpstrParam != ' ')) {
return NULL;
} else {
return (LPWSTR)lpstrParam;
}
}
/*
* @doc INTERNAL MCI
* @func BOOL | mciParseInteger | Parse the given integer
*
* @parm LPWSTR FAR * | lplpstrInput | The string containing the argument.
* It is updated and returned to the caller pointing to the first character
* after the argument or to the first character that is in error.
*
* @parm LPDWORD | lpdwArgument | The place to put the output
*
* @rdesc Returns TRUE if not error
*
* @comm If there are colons in the input (':') the result is "colonized".
* This means that each time a colon is read, the current result is written
* and any subsequent digits are shifted left one byte. No one "segment"
* can be more than 0xFF. For example, "0:1:2:3" is parsed to 0x03020100.
*
*/
STATICFN BOOL NEAR mciParseInteger (
LPCWSTR FAR * lplpstrInput,
LPDWORD lpdwArgument)
{
LPCWSTR lpstrInput = *lplpstrInput;
BOOL fDigitFound;
DWORD dwResult;
DWORD Shift = 0;
int nDigitPosition = 0;
BOOL bSigned = FALSE;
// Leading blanks have been removed by mciParseParams
if (*lpstrInput == '-')
{
++lpstrInput;
bSigned = TRUE;
}
// Read digits
*lpdwArgument = 0; /* Initialize */
dwResult = 0;
fDigitFound = FALSE; /* Initialize */
while (*lpstrInput >= '0' && *lpstrInput <= '9' || *lpstrInput == ':')
{
// ':' indicates colonized data
if (*lpstrInput == ':')
{
// Cannot mix colonized and signed forms
if (bSigned)
{
dprintf1(("mciParseInteger: Bad integer: mixing signed and colonized forms"));
return FALSE;
}
// Check for overflow in accumulated colonized byte
if (dwResult > 0xFF) {
dprintf1(("mciParseInteger: Overflow in accumulated colonized byte"));
return FALSE;
}
// Copy and move to next byte converted in output
*lpdwArgument += dwResult << Shift;
Shift += 8;
++lpstrInput;
// Initialize next colonized byte
dwResult = 0;
++nDigitPosition;
// Only allow four colonized components
if (nDigitPosition > 3)
{
dprintf1(("mciParseInteger: Bad integer: Too many colonized components"));
return FALSE;
}
}
else
{
WCHAR cDigit = (WCHAR)(*lpstrInput++ - '0');
// Satisfies condition that at least one digit must be read
fDigitFound = TRUE;
if (dwResult > 0xFFFFFFFF / 10)
{
// Overflow if multiply was to occur
dprintf1(("mciParseInteger: Multiply overflow pending"));
return FALSE;
}
else
{
// Multiply for next digit
dwResult *= 10;
}
#if 0 // WIN32 Danger Will Robinson horribly bogus technique used here!
// Check to see if adding the new digit will overflow
if (dwResult != 0 && (-(int)dwResult) <= (int)cDigit) {
// Overflow will occur
dprintf1(("mciParseInteger: Add overflow pending"));
return FALSE;
}
#endif
// Add new digit
dwResult += cDigit;
}
}
if (nDigitPosition == 0)
{
// No colonized components
if (bSigned)
{
// Check for overflow from negation
if (dwResult > 0x7FFFFFFF) {
dprintf1(("mciParseInteger: Negation overflow"));
return FALSE;
}
// Negate result because a '-' sign was parsed
dwResult = (DWORD)-(int)dwResult;
}
*lpdwArgument = dwResult;
}
else
// Store last colonized component
{
// Check for overflow
if (dwResult > 0xFF) {
dprintf1(("mciParseInteger: Yet another overflow"));
return FALSE;
}
// Store component
*lpdwArgument += dwResult << Shift;
}
*lplpstrInput = lpstrInput;
/*
If there were no digits or if the digits were followed by a character
other than a blank or a '\0', then return a syntax error.
*/
if (fDigitFound == FALSE ||
(*lpstrInput != ' ' && *lpstrInput != '\0')) {
dprintf1(("mciParseInteger: syntax error"));
return FALSE;
}
else {
dprintf4(("mciParseInteger(%ls, %08XH)", *lplpstrInput, *lpdwArgument));
return TRUE;
}
}
/*
* @doc INTERNAL MCI
* @func BOOL | mciParseConstant | Parse the given integer
*
* @parm LPWSTR FAR * | lplpstrInput | The string containing the argument.
* It is updated and returned to the caller pointing to the first character
* after the argument or to the first character that is in error.
*
* @parm LPDWORD | lpdwArgument | The place to put the output
*
* @parm LPWSTR | lpItem | Pointer into command table.
*
* @rdesc Returns TRUE if not error
*
*/
STATICFN BOOL mciParseConstant (
LPCWSTR FAR * lplpstrInput,
LPDWORD lpdwArgument,
LPWSTR lpItem)
{
LPWSTR lpPrev;
DWORD dwValue;
UINT wID;
// Skip past constant header
(LPBYTE)lpItem = (LPBYTE)lpItem +
mciEatCommandEntry(lpItem, &dwValue, &wID);
while (TRUE)
{
LPWSTR lpstrAfter;
lpPrev = lpItem;
(LPBYTE)lpItem = (LPBYTE)lpItem +
mciEatCommandEntry (lpItem, &dwValue, &wID);
if (wID == MCI_END_CONSTANT) {
break;
}
if ((lpstrAfter = mciCheckToken (lpPrev, *lplpstrInput)) != NULL)
{
*lpdwArgument = dwValue;
*lplpstrInput = lpstrAfter;
return TRUE;
}
}
return mciParseInteger (lplpstrInput, lpdwArgument);
}
/*
* @doc INTERNAL MCI
* @func UINT | mciParseArgument | Parse the given argument
*
* @parm DWORD | dwValue | The argument value
*
* @parm UINT | wID | The argument ID
*
* @parm LPWSTR FAR * | lplpstrOutput | The string containing the argument.
* It is updated and returned to the caller pointing to the first character
* after the argument or to the first character that is in error.
*
* @parm LPDWORD | lpdwFlags | The output flags
*
* @parm LPDWORD | lpArgument | The place to put the output
*
* @rdesc Returns 0 if no error or
* @flag MCIERR_BAD_INTEGER | An integer argument could not be parsed
* @flag MCIERR_MISSING_STRING_ARGUMENT | An expected string argument
* @flag MCIERR_PARM_OVERFLOW | The output buffer was a NULL pointer
* was missing
*
*/
STATICFN UINT mciParseArgument (
UINT uMessage,
DWORD dwValue,
UINT wID,
LPWSTR FAR * lplpstrOutput,
LPDWORD lpdwFlags,
LPWSTR lpArgument,
LPWSTR lpCurrentCommandItem)
{
LPCWSTR lpstrInput = *lplpstrOutput;
UINT wRetval = 0;
int dummy;
/* Switch on the argument type */
dprintf2(("mciParseArgument: msg=%04x, value=%08x, argument=%ls",
uMessage, dwValue, lpArgument));
switch (wID)
{
// The parameter is a flag
case MCI_FLAG:
break;
case MCI_CONSTANT:
if (*lpstrInput == '\0') {
wRetval = MCIERR_NO_INTEGER;
}
else if (!mciParseConstant (&lpstrInput, (LPDWORD)lpArgument,
lpCurrentCommandItem)) {
wRetval = MCIERR_BAD_CONSTANT;
}
// This entire else clause is only for WOW which doesn't exist
// on Win64
#ifndef _WIN64
else if ( WinmmRunningInWOW ) {
//
// Horrible hack: The command table does not contain
// enough information to perform the thunk correctly,
// hence this special case.
//
if ( uMessage == MCI_WINDOW
&& dwValue == MCI_OVLY_WINDOW_HWND
&& !IsWindow( (HWND)*(LPDWORD)lpArgument ) ) {
*(HWND *)lpArgument = HWND32(LOWORD(*(LPDWORD)lpArgument));
}
// If the message is MCI_SETVIDEO and we have
// MCI_DGV_SETVIDEO_VALUE it is possible that we have to
// convert the constant number to a palette handle, but ONLY
// if the ITEM field is "palette handle". We may not know
// that now as the string may be of the form:
// setvideo alias to NNN palette handle
// OR setvideo alias to NNN stream
// Hence any hacking for WOW has to be done when the
// parsing has been completed.
}
#endif // !WIN64
break;
/* Deal with the integer specific cases */
case MCI_HDC:
case MCI_HPAL:
case MCI_INTEGER:
case MCI_HWND:
if (!mciParseInteger (&lpstrInput, (LPDWORD)lpArgument)) {
wRetval = MCIERR_BAD_INTEGER;
}
#ifndef _WIN64
else if ( WinmmRunningInWOW ) {
switch (wID) {
case MCI_HPAL:
/* The parameter has an HPAL argument, try to parse it */
//
// If this specified hpal is not valid, mangle the hpal
// so that it appears to originate from WOW. I use GetObject
// to test the validity of the specified hpal.
//
#ifdef _WIN64
GetObject( (HPALETTE)*(PDWORD_PTR)lpArgument,sizeof(int), &dummy );
#else // !WIN64
if ( !GetObject( (HPALETTE)*(PDWORD_PTR)lpArgument,
sizeof(int), &dummy ) ) {
*(HPALETTE *)lpArgument =
HPALETTE32(LOWORD(*(LPDWORD)lpArgument));
}
#endif // !WIN64
break;
case MCI_HWND:
/* The parameter has an HWND argument, try to parse it */
//
// If this specified hwnd is not valid, mangle the hwnd
// so that it appears to originate from WOW.
//
if ( !IsWindow( (HWND)*(LPDWORD)lpArgument ) ) {
*(HWND *)lpArgument = HWND32(LOWORD(*(LPDWORD)lpArgument));
}
break;
case MCI_HDC:
//
// If this specified hdc is not valid, mangle the hdc
// so that it appears to originate from WOW. I use GetBkMode
// to test the validity of the specified hdc.
//
if ( !GetBkMode( (HDC)*(LPDWORD)lpArgument ) ) {
*(HDC *)lpArgument = HDC32(LOWORD(*(LPDWORD)lpArgument));
}
break;
case MCI_INTEGER:
default: ;
}
}
#endif // !WIN64
break; /* switch */
case MCI_RECT:
{
// Read in four integer parameters. Resulting structure is the
// same as a Windows RECT
LONG lTemp;
int n;
for (n = 0; n < 4; ++n)
{
if (!mciParseInteger (&lpstrInput, (LPDWORD)&lTemp))
{
wRetval = MCIERR_BAD_INTEGER;
break;
}
// Each component is a signed 16 bit number
if (lTemp > 32768 || lTemp < -32767)
{
wRetval = MCIERR_BAD_INTEGER;
break;
}
((int FAR *)lpArgument)[n] = (int)lTemp;
// Remove leading blanks before next digit
while (*lpstrInput == ' ') ++lpstrInput;
}
break;
}
case MCI_STRING:
{
LPWSTR lpstrOutput;
/* The parameter has an string argument, read it */
// Leading blanks have been removed by mciParseParams
/* Are there any non-blank characters left in the input? */
if (*lpstrInput == '\0')
{
/* Return an error */
wRetval = MCIERR_MISSING_STRING_ARGUMENT;
break; /* switch */
}
if ((wRetval = mciEatToken (&lpstrInput, ' ', &lpstrOutput, FALSE))
!= 0)
{
dprintf1(("mciParseArgument: error parsing string"));
return wRetval;
}
*(PDWORD_PTR)lpArgument = (DWORD_PTR)lpstrOutput;
// NOTE: mciSendString frees the output string after command execution
// by calling mciParserFree
break; /* switch */
} /* case */
} /* switch */
/* Update the output flags if there was no error */
if (wRetval == 0)
{
if (*lpdwFlags & dwValue)
{
if (wID == MCI_CONSTANT)
wRetval = MCIERR_FLAGS_NOT_COMPATIBLE;
else
wRetval = MCIERR_DUPLICATE_FLAGS;
} else
*lpdwFlags |= dwValue;
}
/*
Return the input pointer pointing at the first character after
the argument or to the first character that is in error
*/
*lplpstrOutput = (LPWSTR)lpstrInput;
return wRetval;
}
/*
* @doc MCI INTERNAL
* @func UINT | mciParseParams | Parse the command parameters
*
* @parm LPCWSTR | lpstrParams | The parameter string
*
* @parm LPCWSTR | lpCommandList | The command table description
* of the command tokens
*
* @parm LPDWORD | lpdwFlags | Return the parsed flags here
*
* @parm LPDWORD | lpdwOutputParams | Return the list of parameters here
*
* @parm DWORD | dwParamsSize | The size allocated for the parameter list
*
* @parm LPWSTR FAR * FAR * | lpPointerList | A NULL terminated list of
* pointers allocated by this function that should be free'd when
* no longer needed. The list itself should be free'd also. In both
* cases, use mciFree().
*
* @parm PUINT | lpwParsingError | If not NULL then if the command is
* 'open', unrecognized keywords return an error here, and the
* function return value is 0 (unless other errors occur). This
* is used to allow reparsing of the command by mciLoadDevice
*
* @rdesc Returns zero if successful or one of the following error codes:
* @flag MCIERR_PARM_OVERFLOW | Not enough space for parameters
* @flag MCIERR_UNRECOGNIZED_KEYWORD | Unrecognized keyword
*
* @comm Any syntax error, including missing arguments, will result in
* a non-zero error return and invalid output data.
*
*/
UINT mciParseParams (
UINT uMessage,
LPCWSTR lpstrParams,
LPCWSTR lpCommandList,
LPDWORD lpdwFlags,
LPWSTR lpOutputParams,
UINT wParamsSize,
LPWSTR FAR * FAR *lpPointerList,
PUINT lpwParsingError)
{
LPWSTR lpFirstCommandItem, lpCurrentCommandItem;
UINT wArgumentPosition, wErr, wDefaultID;
UINT uLen;
UINT wID;
DWORD dwValue, dwDefaultValue;
BOOL bOpenCommand;
LPWSTR FAR *lpstrPointerList;
UINT wPointers = 0;
UINT wHeaderSize;
LPWSTR lpDefaultCommandItem = NULL;
UINT wDefaultArgumentPosition;
if (lpwParsingError != NULL) {
*lpwParsingError = 0;
}
// If the parameter pointer is NULL, return
if (lpstrParams == NULL)
{
dprintf1(("Warning: lpstrParams is null in mciParseParams()"));
return 0;
}
if ((lpstrPointerList =
mciAlloc ((MCI_MAX_PARAM_SLOTS + 1) * sizeof (LPWSTR)))
== NULL)
{
*lpPointerList = NULL;
return MCIERR_OUT_OF_MEMORY;
}
// If this is the "open" command then allow parameter errors
bOpenCommand = lstrcmpiW((LPWSTR)lpCommandList, wszOpen) == 0;
/* Clear all the flags */
*lpdwFlags = 0;
/* Initialize the entry for the callback message window handle */
/* Each MCI parameter block uses the first word in the parameter */
/* block for the callback window handle. */
wHeaderSize = sizeof (((PMCI_GENERIC_PARMS)lpOutputParams)->dwCallback);
if (wHeaderSize > wParamsSize) { // bit of our caller...
wErr = MCIERR_PARAM_OVERFLOW;
goto error_exit;
}
/* Skip past the header */
lpFirstCommandItem = (LPWSTR)((LPBYTE)lpCommandList
+ mciEatCommandEntry( lpCommandList, NULL, NULL ));
uLen = mciEatCommandEntry (lpFirstCommandItem, &dwValue, &wID);
/* Make room in lpdwOutputParams for the return arguments if any */
if (wID == MCI_RETURN)
{
(LPBYTE)lpFirstCommandItem = (LPBYTE)lpFirstCommandItem + uLen;
wHeaderSize += mciGetParamSize (dwValue, wID);
if (wHeaderSize > wParamsSize) {
wErr = MCIERR_PARAM_OVERFLOW;
goto error_exit;
}
}
(LPBYTE)lpOutputParams = (LPBYTE)lpOutputParams + wHeaderSize; // Each output parameter is LPWSTR size
// Scan the parameter string looking up each parameter in the given
// command list
while (TRUE)
{
LPCWSTR lpstrArgument = NULL;
/* Remove leading blanks */
while (*lpstrParams == ' ') { ++lpstrParams;
}
/* Break at end of parameter string */
if (*lpstrParams == '\0') { break;
}
/* Scan for this parameter in the command list */
lpCurrentCommandItem = lpFirstCommandItem;
wArgumentPosition = 0;
uLen = mciEatCommandEntry (lpCurrentCommandItem, &dwValue, &wID);
/* While there are more tokens in the Command List */
while (wID != MCI_END_COMMAND)
{
/* Check for a default argument if not already read */
if (lpDefaultCommandItem == NULL &&
*lpCurrentCommandItem == '\0')
{
// Remember default argument
lpDefaultCommandItem = lpCurrentCommandItem;
dwDefaultValue = dwValue;
wDefaultID = wID;
wDefaultArgumentPosition = wArgumentPosition;
// break;
}
/* Check to see if this token matches */
else if ((lpstrArgument =
mciCheckToken (lpCurrentCommandItem, lpstrParams)) != NULL)
{ break;
}
/* This token did not match the input but advance the argument position */
wArgumentPosition += mciGetParamSize (dwValue, wID);
/* Go to next token */
(LPBYTE)lpCurrentCommandItem = (LPBYTE)lpCurrentCommandItem + uLen;
// Is this command parameter a constant?
if (wID == MCI_CONSTANT)
{
// Skip constant list
do
(LPBYTE)lpCurrentCommandItem = (LPBYTE)lpCurrentCommandItem
+ mciEatCommandEntry (lpCurrentCommandItem, &dwValue, &wID);
while (wID != MCI_END_CONSTANT);
}
uLen = mciEatCommandEntry (lpCurrentCommandItem, &dwValue, &wID);
} /* while */
/* If there were no matches */
if (lpstrArgument == NULL)
{
// If a default argument exists then try it
if (lpDefaultCommandItem != NULL)
{
lpstrArgument = (LPWSTR)lpstrParams;
dwValue = dwDefaultValue;
wID = wDefaultID;
lpCurrentCommandItem = lpDefaultCommandItem;
wArgumentPosition = wDefaultArgumentPosition;
}
else
{
// Allow missing paramters on OPEN command if indicated by a
// non-null lpwParsingError address
if (!bOpenCommand || lpwParsingError == NULL)
{
wErr = MCIERR_UNRECOGNIZED_KEYWORD;
goto error_exit;
}
else
{
// Skip the parameter if OPEN command
while (*lpstrParams != ' ' && *lpstrParams != '\0')
++lpstrParams;
if (lpwParsingError != NULL)
*lpwParsingError = MCIERR_UNRECOGNIZED_KEYWORD;
continue;
}
}
}
/* Is there room in the output buffer for this argument? */
if (wArgumentPosition + wHeaderSize + mciGetParamSize (dwValue, wID)
> wParamsSize)
{
dprintf1(("mciParseParams: parameter space overflow"));
wErr = MCIERR_PARAM_OVERFLOW;
goto error_exit;
}
// Remove leading blanks
while (*lpstrArgument == ' ') {
++lpstrArgument;
}
/* Process this parameter, filling in any flags or arguments */
if ((wErr = mciParseArgument (uMessage, dwValue, wID,
(LPWSTR FAR *)&lpstrArgument,
lpdwFlags,
(LPWSTR)((LPBYTE)lpOutputParams + wArgumentPosition),
lpCurrentCommandItem))
!= 0)
{
goto error_exit;
}
lpstrParams = lpstrArgument;
if (wID == MCI_STRING)
{
if (wPointers >= MCI_MAX_PARAM_SLOTS)
{
dprintf1(("Warning: Out of pointer list slots in mciParseParams"));
break;
}
lpstrPointerList[wPointers++] =
*((LPWSTR *)((LPBYTE)lpOutputParams + wArgumentPosition));
}
/* Continue reading the parameter string */
} /* while */
// Terminate list
lpstrPointerList[wPointers] = NULL;
// Copy reference for caller
*lpPointerList = lpstrPointerList;
//
// This is a hack to make sure that
// the string version of MCI_SETVIDEO can actually set a palette
// when called from a WOW app.
//
#ifndef _WIN64
if (WinmmRunningInWOW)
{
DWORD dummy; // To hold response from GetObject
if ((uMessage == MCI_SETVIDEO)
&& (*lpdwFlags & MCI_DGV_SETVIDEO_VALUE)
&& (*lpdwFlags & MCI_DGV_SETVIDEO_ITEM)
&& (*(LPDWORD)lpOutputParams == MCI_DGV_SETVIDEO_PALHANDLE)
&& (!GetObject( (HPALETTE)*(((LPDWORD)lpOutputParams)+1),
sizeof(int), &dummy ) ))
{
dprintf2(("Replacing WOW palette handle %x", *(HPALETTE *)(((LPDWORD)lpOutputParams)+1)));
*(HPALETTE *)(((LPDWORD)lpOutputParams)+1) =
HPALETTE32(LOWORD(*(((LPDWORD)lpOutputParams)+1) ));
dprintf2(("WOW palette handle now %x", *(HPALETTE *)(((LPDWORD)lpOutputParams)+1)));
}
}
#endif // !WIN64
// Return Success
return 0;
error_exit:
*lpPointerList = NULL;
// Terminate list
lpstrPointerList[wPointers] = NULL;
mciParserFree (lpstrPointerList);
return(wErr);
}
/*
* @doc INTERNAL MCI
* @func UINT | mciParseCommand | This function converts an MCI
* control string to an MCI control message suitable for sending to
* <f mciSendCommand>. The input string usually comes from <f mciSendString>
* and always has the device name stripped off the front.
*
* @parm MCIDEVICEID | wDeviceID | Identifies the device. First searches the
* parsing table belonging to the driver.
* Then searches the command tables matching the type
* of the given device. Then searches the core command table.
*
* @parm LPWSTR | lpstrCommand | An MCI control command without
* a device name prefix. There must be no leading or trailing
* blanks.
*
* @parm LPCWSTR | lpstrDeviceName | The device name (second token on the
* command line). It is used to identify the device type.
*
* @parm LPWSTR FAR * | lpCommandList | If not NULL then the address of
* the command list for the parsed command (if successful) is copied here.
* It is used later by mciSendString when parsing arguments
*
* @parm PUINT | lpwTable | The table resource ID to be unlocked
* after parsing. Returned to caller.
*
* @rdesc Returns the command ID or 0 if not found.
*
*/
UINT mciParseCommand (
MCIDEVICEID wDeviceID,
LPWSTR lpstrCommand,
LPCWSTR lpstrDeviceName,
LPWSTR * lpCommandList,
PUINT lpwTable)
{
LPWSTR lpCommandItem;
UINT wMessage;
dprintf2(("mciParseCommand(%ls, %ls)", lpstrCommand ? lpstrCommand : L"(NULL)", lpstrDeviceName ? lpstrDeviceName : L"(NULL)"));
// Put the command in lower case
// mciToLower (lpstrCommand);
// Look up lpstrCommand in the parser's command tables.
if ((lpCommandItem = FindCommandItem (wDeviceID, lpstrDeviceName,
lpstrCommand,
&wMessage, lpwTable))
== NULL) {
return 0;
}
/* Return the command list to the caller */
if (lpCommandList != NULL) {
*lpCommandList = lpCommandItem;
} else {
dprintf1(("Warning: NULL lpCommandList in mciParseCommand"));
}
return wMessage;
}
/*
* @doc INTERNAL MCI
* @func VOID | mciParserFree | Free any buffers allocated to
* receive string arguments.
*
* @parm LPWSTR FAR * | lpstrPointerList | A NULL terminated list of far
* pointers to strings to be free'd
*
*/
VOID mciParserFree (
LPWSTR FAR *lpstrPointerList)
{
LPWSTR FAR *lpstrOriginal = lpstrPointerList;
if (lpstrPointerList == NULL) {
return;
}
while (*lpstrPointerList != NULL) {
mciFree (*lpstrPointerList++);
}
mciFree (lpstrOriginal);
}