Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

quality command

The quality command defines a custom quality level for either audio, video or still image data compression. Digital-video devices recognize this command.

To send this command, call the mciSendString function with the lpszCommand parameter set as follows.


_stprintf_s(
  lpszCommand, 
  TEXT("quality %s %s %s"), 
  lpszDeviceID, 
  lpszQuality, 
  lpszFlags
); 

Parameters

lpszDeviceID

Identifier of an MCI device. This identifier or alias is assigned when the device is opened.

lpszQuality

One or more of the following flags. (One of the three flags "audio", "still", and "video" must be present.)

ValueMeaning
algorithm algorithmAssociates the quality level with the specified algorithm. This algorithm must be supported by the device and be compatible with the "audio", "still", or "video" flag that is used. If omitted, the current algorithm is used.
audio nameIndicates this command specifies an "audio" quality level identified with name.
dialogRequests that the device display a dialog box. This dialog box has algorithm-specific fields that are used internally by the device to create the structure describing a specific quality level.
handle handleSpecifies a handle to a structure that contains algorithmic-specific data describing a specific quality level. The structures for the data referenced by this handle are device specific.
still nameIndicates the command specifies a "still" quality level identified with name.
video nameIndicates the command specifies a "video" quality level identified with name.

 

lpszFlags

Can be "wait", "notify", "test", or a combination of these. For more information about these flags, see The Wait, Notify, and Test Flags.

Return Value

Returns zero if successful or an error otherwise.

Remarks

This command defines a string name for the quality level, which can then be used in a setvideo "quality", setvideo "still quality", or setaudio "quality" command to establish it as the current video, still, or audio-compression quality level.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

See also

MCI
MCI Command Strings
setaudio
setvideo

 

 

Community Additions

Show:
© 2014 Microsoft