MCI_QUALITY
The MCI_QUALITY
command defines a custom quality level for audio, video, or still image data
compression. Digital-video devices recognize this command.
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
Address of an
MCI_DGV_QUALITY_PARMS
structure.
Return Values
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.
See Also