Compartilhar via


comando MCI_REALIZE

O comando MCI_REALIZE faz com que um dispositivo gráfico realize sua paleta em um DC (contexto de dispositivo). 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_REALIZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpRealize
);

Parâmetros

wDeviceID

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

dwFlags

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

lpRealize

Ponteiro para uma estrutura MCI_GENERIC_PARMS . (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Valor Retornado

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

Comentários

Você deve usar esse comando quando o aplicativo receber a mensagem WM_QUERYNEWPALETTE .

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo "digitalvideo":

MCI_DGV_REALIZE_BKGD

Percebe a paleta como uma paleta de plano de fundo.

MCI_DGV_REALIZE_NORM

Percebe a paleta normalmente. Esse é o padrão.

Para dispositivos de vídeo digital, o parâmetro lpRealize aponta para uma estrutura MCI_REALIZE_PARMS . Para obter mais informações, consulte comentários na estrutura MCI_GENERIC_PARMS .

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