Função MCIWndCreateW (vfw.h)

Artigo
11/20/2024

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

Sintaxe

HWND VFWAPIV MCIWndCreateW(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCWSTR   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 aos 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 o MCIWnd use uma cadeia de caracteres ANSI em vez de uma cadeia de caracteres Unicode ao notificar a janela pai das alterações no 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 altera os modos operacionais. O parâmetro lParam dessa mensagem identifica o novo modo, como MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS	Faz com que o 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 desta mensagem contém a nova posição no conteúdo.
MCIWNDF_NOTIFYMEDIA	Faz com que o MCIWnd notifique a janela pai com uma mensagem de MCIWNDM_NOTIFYMEDIA sempre que um novo dispositivo é usado ou um arquivo de dados é aberto ou fechado. O parâmetro lParam dessa mensagem contém um ponteiro para o novo nome do arquivo.
MCIWNDF_NOTIFYSIZE	Faz com que o MCIWnd notifique a janela pai quando o tamanho da janela MCIWnd for alterado.
MCIWNDF_NOTIFYERROR	Faz com que o 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.

Valor de retorno

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

Observações

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 NULL nãode 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 de 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	vfw.h
biblioteca	Vfw32.lib
de DLL	Msvfw32.dll

Consulte também

MCIWNDM_NOTIFYMEDIA

MCIWNDM_NOTIFYMODE

MCIWNDM_NOTIFYPOS

MCIWndGetMode

MCIWndRegisterClass

Compartilhar via