Jump to content

mciSetSysValue

From EDM2
Revision as of 04:29, 25 November 2025 by Martini (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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