comando MCI_OPEN
O comando MCI_OPEN inicializa um dispositivo ou arquivo. Todos os dispositivos reconhecem esse comando.
Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_OPEN,
DWORD dwFlags,
(DWORD) (LPMCI_OPEN_PARMS) lpOpen
);
Parâmetros
-
wDeviceID
-
Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.
-
dwFlags
-
MCI_NOTIFY ou MCI_WAIT. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.
-
lpOpen
-
Ponteiro para uma estrutura de MCI_OPEN_PARMS . (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)
Valor Retornado
Retorna zero se tiver êxito ou um erro de outra forma.
Comentários
O sinalizador MCI_OPEN_TYPE deve ser usado sempre que um dispositivo é especificado na função mciSendCommand . Se você abrir um dispositivo especificando uma constante de tipo de dispositivo, deverá especificar o sinalizador MCI_OPEN_TYPE_ID além de MCI_OPEN_TYPE. Para obter uma lista de constantes do tipo dispositivo, consulte Tipos de dispositivo MCI.
Se o sinalizador MCI_OPEN_SHAREABLE não for especificado quando um dispositivo ou arquivo for aberto inicialmente, todos os comandos MCI_OPEN subsequentes para o dispositivo ou arquivo falharão. Se o dispositivo ou arquivo já estiver aberto e esse sinalizador não for especificado, a chamada falhará mesmo se o primeiro comando aberto especificado MCI_OPEN_SHAREABLE. Arquivos abertos para o MCISEQ. DRV e MCIWAVE. Os dispositivos DRV não podem ser usados.
Case é ignorado no nome do dispositivo, mas não pode haver espaços em branco à esquerda ou à direita.
Para usar a seleção automática de tipo (por meio das entradas no registro), atribua o nome do arquivo e a extensão de arquivo ao membro lpstrElementName da estrutura identificada por lpOpen, defina o membro lpstrDeviceType como NULL e defina o sinalizador MCI_OPEN_ELEMENT.
Os seguintes sinalizadores adicionais se aplicam a todos os dispositivos que dão suporte a MCI_OPEN:
-
MCI_OPEN_ALIAS
-
Um alias é incluído no membro lpstrAlias da estrutura identificada por lpOpen.
-
MCI_OPEN_SHAREABLE
-
O dispositivo ou arquivo deve ser aberto como fragmentável.
-
MCI_OPEN_TYPE
-
Um nome de tipo de dispositivo ou constante está incluído no membro lpstrDeviceType da estrutura identificada por lpOpen.
-
MCI_OPEN_TYPE_ID
-
A palavra de baixa ordem do membro lpstrDeviceType da estrutura identificada por lpOpen contém um identificador de tipo de dispositivo MCI padrão e a palavra de alta ordem contém opcionalmente o índice ordinal do dispositivo. Use esse sinalizador com o sinalizador MCI_OPEN_TYPE.
Os seguintes sinalizadores adicionais se aplicam a dispositivos compostos:
-
MCI_OPEN_ELEMENT
-
Um nome de arquivo é incluído no membro lpstrElementName da estrutura identificada por lpOpen.
-
MCI_OPEN_ELEMENT_ID
-
O membro lpstrElementName da estrutura identificada por lpOpen é interpretado como um valor DWORD e tem significado interno para o dispositivo. Use esse sinalizador com o sinalizador MCI_OPEN_ELEMENT.
Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo digitalvideo :
-
MCI_DGV_OPEN_NOSTATIC
-
O dispositivo deve reduzir o número de cores estáticas (sistema) na paleta. Isso aumenta o número de cores disponíveis para renderizar o fluxo de vídeo. Esse sinalizador se aplica somente a dispositivos que compartilham uma paleta com o Windows.
-
MCI_DGV_OPEN_PARENT
-
O identificador de janela pai é especificado no membro hWndParent da estrutura identificada por lpOpen.
-
MCI_DGV_OPEN_WS
-
Um estilo de janela é especificado no membro dwStyle da estrutura identificada por lpOpen.
-
MCI_DGV_OPEN_16BIT
-
Indica uma preferência para suporte ao dispositivo MCI de 16 bits.
-
MCI_DGV_OPEN_32BIT
-
Indica uma preferência para o suporte ao dispositivo MCI de 32 bits.
Para dispositivos de vídeo digital, o parâmetro lpOpen aponta para uma estrutura MCI_DGV_OPEN_PARMS .
Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo de sobreposição :
-
MCI_OVLY_OPEN_PARENT
-
O identificador de janela pai é especificado no membro hWndParent da estrutura identificada por lpOpen.
-
MCI_OVLY_OPEN_WS
-
Um estilo de janela é especificado no membro dwStyle da estrutura identificada por lpOpen. O valor dwStyle especifica o estilo da janela que o driver criará e exibirá se o aplicativo não fornecer um. O parâmetro de estilo usa um inteiro que define o estilo da janela. Essas constantes são iguais aos estilos de janela padrão (como WS_CHILD, WS_OVERLAPPEDWINDOW ou WS_POPUP).
Para dispositivos de sobreposição de vídeo, o parâmetro lpOpen aponta para uma estrutura MCI_OVLY_OPEN_PARMS .
O seguinte sinalizador adicional é usado com o tipo de dispositivo waveaudio :
-
MCI_WAVE_OPEN_BUFFER
-
Um comprimento de buffer é especificado no membro dwBufferSeconds da estrutura identificada por lpOpen.
Para dispositivos de áudio de forma de onda, o parâmetro lpOpen aponta para uma estrutura MCI_WAVE_OPEN_PARMS . O driver MCIWAVE requer um dispositivo de áudio de forma de onda assíncrona.
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 |
|