comando MCI_WINDOW

O comando MCI_WINDOW especifica a janela e as características da janela para dispositivos gráficos. Os dispositivos de vídeo digital e sobreposição de vídeo reconhecem esse comando.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WINDOW, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpWindow
);

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.

lpWindow

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

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

Os dispositivos gráficos devem criar uma janela padrão quando um dispositivo é aberto, mas não devem exibi-lo até que recebam o comando MCI_PLAY . O comando MCI_WINDOW é usado para fornecer uma janela criada pelo aplicativo para o dispositivo e alterar as características de exibição de uma janela de exibição definida pelo aplicativo ou padrão. Se o aplicativo fornecer a janela de exibição, ele deverá estar preparado para atualizar um retângulo inválido na janela.

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

MCI_DGV_WINDOW_HWND

O identificador da janela necessária para uso como destino está incluído no membro hWnd da estrutura identificada por lpWindow.

MCI_DGV_WINDOW_STATE

O membro nCmdShow da estrutura identificada por lpWindow contém parâmetros para definir o estado da janela.

MCI_DGV_WINDOW_TEXT

O membro lpstrText da estrutura identificada por lpWindow contém um endereço de um buffer que contém o legenda usado na barra de título da janela.

Para dispositivos de vídeo digital, o parâmetro lpWindow aponta para uma estrutura MCI_DGV_WINDOW_PARMS .

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo de sobreposição :

MCI_OVLY_WINDOW_DISABLE_STRETCH

Desabilita o alongamento da imagem.

MCI_OVLY_WINDOW_ENABLE_STRETCH

Habilita o alongamento da imagem.

MCI_OVLY_WINDOW_HWND

O identificador da janela usada para o destino está incluído no membro hWnd da estrutura identificada por lpWindow. Defina esse sinalizador como MCI_OVLY_WINDOW_DEFAULT para retornar à janela padrão.

MCI_OVLY_WINDOW_STATE

O membro nCmdShow da estrutura lpWindow contém parâmetros para definir o estado da janela. Esse sinalizador é equivalente a chamar ShowWindow com o parâmetro state . As constantes são as mesmas definidas no WINDOWS. H (como SW_HIDE, SW_MINIMIZE ou SW_SHOWNORMAL).

MCI_OVLY_WINDOW_TEXT

O membro lpstrText da estrutura identificada por lpWindow contém um endereço de um buffer que contém o legenda usado para a janela.

Para dispositivos de sobreposição de vídeo, o parâmetro lpWindow aponta para uma estrutura de MCI_OVLY_WINDOW_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 (incluir Windows.h)

Confira também

MCI

Comandos MCI