The MCI_QUALITY command defines a custom quality level for audio, video, or still image data compression. Digital-video devices recognize this command.
To send this command, call the mciSendCommand function with the following parameters.
MCIERROR mciSendCommand( MCIDEVICEID wDeviceID, MCI_QUALITY, DWORD dwFlags, (DWORD) (LPMCI_DGV_QUALITY_PARMS) lpQuality );
Device identifier of the MCI device that is to receive the command message.
MCI_NOTIFY, MCI_WAIT, or MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.
Pointer to an MCI_DGV_QUALITY_PARMS structure.
Returns zero if successful or an error otherwise.
The name defined for this quality level can be used when setting the audio, video, or still quality with the MCI_SETAUDIO and MCI_SETVIDEO commands.
The following additional flags apply to digital-video devices:
The lpstrAlgorithm member of the structure identified by lpQuality contains an address of a buffer containing the name of the algorithm. This algorithm must be supported by the device driver, and must be compatible with the audio, still, or video descriptor that is used. If this flag is omitted, the current algorithm is used.
The device driver should display a dialog box for specifying the quality level. The dialog box has algorithm-specific fields used internally by the device driver to create a structure describing a specific quality level.
The dwHandle member of the structure identified by lpQuality contains a handle to a structure. The structure contains algorithmic-specific data describing the specific quality level. The format of the structures for the algorithms is device dependent.
A constant indicating the type of algorithm is included in the dwItem member of the structure identified by lpQuality.
The lpstrName member of the structure identified by lpQuality contains an address of a buffer containing the quality descriptor.
** Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
** Windows 95/98/Me:** Included in Windows 95 and later.
** Header:** Declared in Mmsystem.h; include Windows.h.
MCI, MCI Commands, MCI_DGV_QUALITY_PARMS, MCI_SETAUDIO, MCI_SETVIDEO