Compartilhar via


comando MCI_QUALITY

O comando MCI_QUALITY define um nível de qualidade personalizado para compactação de dados de áudio, vídeo ou imagem. Os dispositivos de vídeo digital reconhecem esse comando.

Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_QUALITY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_QUALITY_PARMS) lpQuality
);

Parâmetros

wDeviceID

Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpQuality

Ponteiro para uma estrutura MCI_DGV_QUALITY_PARMS .

Valor Retornado

Retorna zero se tiver êxito ou um erro de outra forma.

Comentários

O nome definido para esse nível de qualidade pode ser usado ao definir o áudio, o vídeo ou ainda a qualidade com os comandos MCI_SETAUDIO e MCI_SETVIDEO .

Os seguintes sinalizadores adicionais se aplicam a dispositivos de vídeo digital:

MCI_QUALITY_ALG

O membro lpstrAlgorithm da estrutura identificada por lpQuality contém um endereço de um buffer que contém o nome do algoritmo. Esse algoritmo deve ser compatível com o driver do dispositivo e deve ser compatível com o descritor de áudio, ainda ou vídeo usado. Se esse sinalizador for omitido, o algoritmo atual será usado.

MCI_QUALITY_DIALOG

O driver do dispositivo deve exibir uma caixa de diálogo para especificar o nível de qualidade. A caixa de diálogo tem campos específicos do algoritmo usados internamente pelo driver do dispositivo para criar uma estrutura que descreve um nível de qualidade específico.

MCI_QUALITY_HANDLE

O membro dwHandle da estrutura identificada por lpQuality contém um identificador para uma estrutura. A estrutura contém dados específicos de algoritmo que descrevem o nível de qualidade específico. O formato das estruturas para os algoritmos depende do dispositivo.

MCI_QUALITY_ITEM

Uma constante que indica que o tipo de algoritmo está incluído no membro dwItem da estrutura identificada por lpQuality.

MCI_QUALITY_NAME

O membro lpstrName da estrutura identificada por lpQuality contém um endereço de um buffer que contém o descritor de qualidade.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Mmsystem.h (inclua Windows.h)

Confira também

MCI

Comandos MCI