MCI_QUALITY command
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
);
Parameters
-
wDeviceID
-
Device identifier of the MCI device that is to receive the command message.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, or MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.
-
lpQuality
-
Pointer to an MCI_DGV_QUALITY_PARMS structure.
Return Value
Returns zero if successful or an error otherwise.
Remarks
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:
-
MCI_QUALITY_ALG
-
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.
-
MCI_QUALITY_DIALOG
-
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.
-
MCI_QUALITY_HANDLE
-
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.
-
MCI_QUALITY_ITEM
-
A constant indicating the type of algorithm is included in the dwItem member of the structure identified by lpQuality.
-
MCI_QUALITY_NAME
-
The lpstrName member of the structure identified by lpQuality contains an address of a buffer containing the quality descriptor.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|