Função MCIWndCreateA (vfw.h)

  • Artigo

A função MCIWndCreate registra a classe de janela MCIWnd e cria uma janela MCIWnd para usar serviços MCI. MCIWndCreate também pode abrir um dispositivo ou arquivo MCI (como um arquivo AVI) e associá-lo à janela MCIWnd.

Sintaxe

HWND VFWAPIV MCIWndCreateA(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCSTR    szFile
);

Parâmetros

hwndParent

Manipule para a janela pai.

hInstance

Manipule para a instância do módulo a ser associada à janela MCIWnd.

dwStyle

Sinalizadores definindo o estilo da janela. Além de especificar os estilos de janela usados com a função CreateWindowEx , você pode especificar os estilos a seguir a serem usados com janelas MCIWnd.

Valor Significado
MCIWNDF_NOAUTOSIZEWINDOW Não alterará as dimensões de uma janela MCIWnd quando o tamanho da imagem for alterado.
MCIWNDF_NOAUTOSIZEMOVIE Não alterará as dimensões do retângulo de destino quando um tamanho de janela MCIWnd for alterado.
MCIWNDF_NOERRORDLG Inibe a exibição de erros de MCI para os usuários.
MCIWNDF_NOMENU Oculta o botão Menu da exibição na barra de ferramentas e proíbe que os usuários acessem seu menu pop-up.
MCIWNDF_NOOPEN Oculta os comandos abertos e fechados do menu MCIWnd e proíbe que os usuários acessem essas opções no menu pop-up.
MCIWNDF_NOPLAYBAR Oculta a barra de ferramentas da exibição e proíbe os usuários de acessá-la.
MCIWNDF_NOTIFYANSI Faz com que MCIWnd use uma cadeia de caracteres ANSI em vez de uma cadeia de caracteres Unicode ao notificar as alterações na janela pai do modo de dispositivo. Esse sinalizador é usado em combinação com MCIWNDF_NOTIFYMODE.
MCIWNDF_NOTIFYMODE Faz com que o MCIWnd notifique a janela pai com uma mensagem MCIWNDM_NOTIFYMODE sempre que o dispositivo alterar os modos operacionais. O parâmetro lParam dessa mensagem identifica o novo modo, como MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS Faz com que MCIWnd notifique a janela pai com uma mensagem MCIWNDM_NOTIFYPOS sempre que ocorrer uma alteração na posição de reprodução ou registro dentro do conteúdo. O parâmetro lParam dessa mensagem contém a nova posição no conteúdo.
MCIWNDF_NOTIFYMEDIA Faz com que MCIWnd notifique a janela pai com uma mensagem MCIWNDM_NOTIFYMEDIA sempre que um novo dispositivo for usado ou um arquivo de dados for aberto ou fechado. O parâmetro lParam dessa mensagem contém um ponteiro para o novo nome de arquivo.
MCIWNDF_NOTIFYSIZE Faz com que MCIWnd notifique a janela pai quando o tamanho da janela MCIWnd for alterado.
MCIWNDF_NOTIFYERROR Faz com que MCIWnd notifique a janela pai quando ocorrer um erro mci.
MCIWNDF_NOTIFYALL Faz com que todos os estilos de notificação da janela MCIWNDF sejam usados.
MCIWNDF_RECORD Adiciona um botão Gravar à barra de ferramentas e adiciona um novo comando de arquivo ao menu se o dispositivo MCI tiver capacidade de gravação.
MCIWNDF_SHOWALL Faz com que todos os estilos MCIWNDF_SHOW sejam usados.
MCIWNDF_SHOWMODE Exibe o modo atual do dispositivo MCI na barra de título da janela. Para obter uma lista de modos de dispositivo, consulte a macro MCIWndGetMode .
MCIWNDF_SHOWNAME Exibe o nome do dispositivo MCI aberto ou do arquivo de dados na barra de título da janela MCIWnd.
MCIWNDF_SHOWPOS Exibe a posição atual dentro do conteúdo do dispositivo MCI na barra de título da janela.

szFile

Cadeia de caracteres terminada em nulo que indica o nome de um dispositivo MCI ou arquivo de dados a ser aberto.

Retornar valor

Retorna o identificador para uma janela MCI se tiver êxito ou zero caso contrário.

Comentários

Os estilos de janela padrão para uma janela filho são WS_CHILD, WS_BORDER e WS_VISIBLE. MCIWndCreate pressupõe uma janela filho quando um identificador não NULL de uma janela pai é especificado.

Os estilos de janela padrão para uma janela pai são WS_OVERLAPPEDWINDOW e WS_VISIBLE. MCIWndCreate pressupõe uma janela pai quando um identificador NULL de uma janela pai é especificado.

Use o identificador de janela retornado por essa função para o identificador de janela nas macros MCIWnd. Se o aplicativo usar essa função, ele não precisará usar a função MCIWndRegisterClass .

Observação

O cabeçalho vfw.h define MCIWndCreate como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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]
Plataforma de Destino Windows
Cabeçalho vfw.h
Biblioteca Vfw32.lib
DLL Msvfw32.dll

Confira também

MCIWNDM_NOTIFYMEDIA

MCIWNDM_NOTIFYMODE

MCIWNDM_NOTIFYPOS

MCIWndGetMode

MCIWndRegisterClass