MciSetSysValue

This function sets the value of system-defined attributes.

Syntax

mciSetSysValue(iSysValue, pValue)

Parameters

iSysValue (USHORT) - input

The system attribute. See mciQuerySysValue for a list of possible system attributes.

pValue (PVOID) - input

Pointer to a value to be set. The type of data object this points to is dependent on the attribute requested. See mciQuerySysValue for a list of data types.

Returns

rc (BOOL) - returns

Return code.

• TRUE If the function succeeds.
• FALSE If the function fails.

Remarks

Most of the system values can be changed by way of the Multimedia Setup program to reflect the preferences of the end user. In general, other applications should only query these values.

Example Code

#include <os2.h>

USHORT iSysValue; /* System attribute. */
PVOID pValue; /* Pointer to value. */
BOOL rc; /* Return code. */

rc = mciSetSysValue(iSysValue, pValue);

/* The following code illustrates how to set a multimedia system value. */

 /* Turn closed captioning flag on so
    applications will provide captioning */

    mciSetSysValue (MSV_CLOSEDCAPTION, TRUE);

Related Functions

• mciQuerySysValue