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	Mmsystem.h (inclua Windows.h)

Confira também

MCI

Comandos MCI