comando realize

  • Artigo

O comando realize instrui um dispositivo a selecionar e realizar sua paleta no contexto de exibição da janela exibida. Os dispositivos de vídeo digital reconhecem esse comando.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

_stprintf_s(
  lpszCommand, 
  TEXT("realize %s %s %s"), 
  lpszDeviceID, 
  lpszPalette, 
  lpszFlags
);

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszPalette

Um dos sinalizadores a seguir.

Valor Significado
background Percebe a paleta como uma paleta de plano de fundo.
normal Percebe a paleta de uma janela de nível superior. Essa é a configuração padrão.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital, o "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

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

Comentários

Use esse comando somente se o aplicativo usar um identificador de janela e receber uma mensagem WM_QUERYNEWPALLETTE ou WM_PALETTECHANGED .

Exemplos

O comando a seguir informa ao dispositivo "myvideo" para realizar sua paleta.

realize myvideo normal

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]

Confira também

MCI

Cadeias de caracteres de comando MCI