MCI_QUALITY

This command message defines a custom quality level for audio, video, or still image data compression. 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.

Parameters

DWORD lParam1

The following standard and command-specific flags apply to all devices supporting this command:

MCI_NOTIFY	Specifies that MCI should post the MM_MCINOTIFY message when this command completes. The window that receives this message is specified in the dwCallback field of the data structure identified by lParam2.
MCI_TEST	Queries the device to determine if it can execute the command. The device returns an error if it is incapable of executing the command. It returns no error if it can handle the command. MCI returns control to the application without executing the command.
MCI_WAIT	Specifies that the operation should finish before MCI returns control to the application.
MCI_QUALITY_ITEM	Specifies that a constant indicating the type of algorithm is included in the dwItem field of the data structure identified by lParam2. Use one of the following constants to indicate the type of algorithm:

	MCI_QUALITY_ITEM_AUDIO	Indicates the definitions are for an audio compression algorithm.
	MCI_QUALITY_ITEM_STILL	Indicates the definitions are for a still video compression algorithm.
	MCI_QUALITY_ITEM_VIDEO	Indicates the definitions are for a video compression algorithm.

MCI_QUALITY_NAME	Indicates the lpstrName field of the data structure identified by lParam2 contains a pointer to a buffer containing the quality descriptor.
MCI_QUALITY_ALG	Indicates the lpstrAlgorithm field of the data structure identified by lParam2 contains a pointer to 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 then the current algorithm is used.
MCI_QUALITY_DIALOG	Requests that the device driver 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 data structure describing to achieve a specific quality level.
MCI_QUALITY_HANDLE	Indicates the dwHandle field of the data structure identified by lParam2 contains a handle to a data structure. The data structure contains algorithmic-specific data describing the specific quality level. The format of the data structures for the algorithms is device dependent.
LPMCI_DGV_QUALITY_PARMS lParam2	Specifies a far pointer to a MCI_DGV_QUALITY_PARMS data structure.
Return Value	Returns zero if successful. Otherwise, it returns an MCI error code.
Comments	The algorithm and quality level for the stored data is set with the MCI_SETAUDIO and MCI_SETVIDEO commands.
See Also	MCI_SETAUDIO, MCI_SETVIDEO