Função MCIWndCreateA (vfw.h)
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 |