Classificações de comandos MCI
[O recurso associado a esta página, mci, é um recurso herdado. Foi substituído por MediaPlayer. MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use mediaplayer em vez de mci, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O MCI define quatro classificações de comando: sistema, obrigatório, básico e estendido. A lista a seguir descreve estas classificações de comando:
- comandos do sistema são tratados diretamente pela MCI, e não pelo driver.
- comandos necessários são tratados pelo driver. Todos os drivers mci devem dar suporte aos comandos e sinalizadores necessários.
- comandos básicos (ou comandos opcionais) são usados por alguns dispositivos. Se um dispositivo der suporte a um comando básico, ele deverá dar suporte a um conjunto definido de sinalizadores para esse comando.
- comandos estendidos são específicos para um tipo de dispositivo ou driver. Os comandos estendidos incluem comandos, como os comandos put (MCI_PUT) e onde (MCI_WHERE) comandos para o digitalvideo e sobreposição tipos de dispositivo e extensões para comandos existentes (como o sinalizador "stretch" do comando status (MCI_STATUS) para o tipo de dispositivo de sobreposição).
Embora o sistema e os comandos necessários sejam o conjunto de comandos mínimo para qualquer driver MCI, comandos básicos e estendidos não são compatíveis com todos os drivers. Seu aplicativo sempre pode usar comandos e comandos necessários e seus sinalizadores, mas se ele precisar usar um comando ou sinalizador básico ou estendido, ele deve primeiro consultar o driver usando o comandode funcionalidade(MCI_GETDEVCAPS). As seções a seguir resumem os comandos específicos em cada categoria.
Comandos do sistema
O MCI processa os comandos do sistema a seguir diretamente, em vez de passá-los para dispositivos MCI.
| Corda | Mensagem | Descrição |
|---|---|---|
| de interrupção | MCI_BREAK | Define uma tecla de interrupção para um dispositivo MCI. |
| sysinfo | MCI_SYSINFO | Retorna informações sobre dispositivos MCI. |
Comandos necessários
Todos os dispositivos MCI dão suporte aos comandos necessários a seguir.
| Corda | Mensagem | Descrição |
|---|---|---|
| de funcionalidade de | MCI_GETDEVCAPS | Obtém os recursos de um dispositivo. |
| fechar | MCI_CLOSE | Fecha o dispositivo. |
| informações | MCI_INFO | Obtém informações textuais de um dispositivo. |
| abrir | MCI_OPEN | Inicializa o dispositivo. |
| status | MCI_STATUS | Obtém informações de status do dispositivo. Alguns dos sinalizadores desse comando não são necessários, portanto, também é um comando básico. |
Os dispositivos também devem dar suporte a um conjunto padrão de sinalizadores de comando para os comandos necessários.
Comandos básicos
A lista a seguir resume os comandos básicos. O uso desses comandos por um dispositivo MCI é opcional.
| Corda | Mensagem | Descrição |
|---|---|---|
| de carga | MCI_LOAD | Carrega dados de um arquivo. |
| pausar | MCI_PAUSE | Para de jogar. A reprodução ou gravação pode ser retomada na posição atual. |
| jogar | MCI_PLAY | Inicia a transmissão de dados de saída. |
| registro | MCI_RECORD | Inicia a gravação de dados de entrada. |
| retomar | MCI_RESUME | Retoma a reprodução ou gravação em um dispositivo em pausa. |
| salvar | MCI_SAVE | Salva dados em um arquivo de disco. |
| procurar | MCI_SEEK | Busca para frente ou para trás. |
| definir | MCI_SET | Define o estado operacional do dispositivo. |
| status | DE STATUS DO MCI | Obtém informações de status sobre o dispositivo. Esse também é um comando necessário; como alguns de seus sinalizadores não são necessários, ele também está listado aqui. (Os itens opcionais dão suporte a dispositivos que usam mídia linear com posições identificáveis.) |
| parar | MCI_STOP | Para de jogar. |
Se um driver der suporte a um comando básico, ele também deverá dar suporte a um conjunto padrão de sinalizadores para o comando.
Comandos Estendidos
Alguns dispositivos MCI têm comandos adicionais ou adicionam sinalizadores a comandos existentes. Embora alguns comandos estendidos se apliquem apenas a um driver de dispositivo específico, a maioria deles se aplica a todos os drivers de um determinado tipo de dispositivo. Por exemplo, o conjunto de comandos do sequenciador tipo de dispositivo estende o comando set (MCI_SET) para adicionar formatos de tempo necessários para sequenciadores MIDI.
Você não deve assumir que o dispositivo dá suporte aos comandos ou sinalizadores estendidos. Você pode usar o comando capability (MCI_GETDEVCAPS) para determinar se um recurso específico tem suporte e seu aplicativo deve estar pronto para lidar com valores retornados de "comando sem suporte" ou "função sem suporte".
Os comandos estendidos a seguir estão disponíveis com os tipos de dispositivo listados.
| Corda | Mensagem | Tipos de dispositivo | Descrição |
|---|---|---|---|
| configurar | MCI_CONFIGURE | digitalvideo | Exibe uma caixa de diálogo de configuração. |
| MCI_CUE | digitalvideo, waveaudio | Prepara-se para reprodução ou gravação. | |
| excluir | MCI_DELETE | waveaudio | Exclui um segmento de dados do arquivo de mídia. |
| de escape | MCI_ESCAPE | videodisc | Envia informações personalizadas para um dispositivo. |
| congelar | MCI_FREEZE | recobrir | Desabilita a aquisição de vídeo para o buffer de quadros. |
| colocar | MCI PUT | digitalvideo, sobreposição | Define as janelas de origem, destino e quadro. |
| perceber | MCI_REALIZE | digitalvideo | Informa ao dispositivo para selecionar e realizar sua paleta em um contexto de dispositivo da janela exibida. |
| setaudio | MCI_ SETAUDIO | digitalvideo | Define parâmetros de áudio para vídeo. |
| setvideo | MCI_ SETVIDEO | digitalvideo | Define parâmetros de vídeo. |
| de sinal | MCI_SIGNAL | digitalvideo | Identifica uma posição especificada com um sinal. |
| de rotação | MCI_SPIN | videodisc | Inicia a rotação de disco ou impede a rotação do disco. |
| etapa | MCI_STEP | digitalvideo, videodisc | Etapas da reprodução de um ou mais quadros para frente ou inverso. |
| descongelar | MCI_UNFREEZE | recobrir | Permite que o buffer de quadros adquira dados de vídeo. |
| atualizar | MCI_UPDATE | digitalvideo | Reintiza o quadro atual no contexto do dispositivo. |
| onde | MCI WHERE | digitalvideo, sobreposição | Obtém o retângulo que especifica a área de origem, destino ou quadro. |
| da janela | MCI_WINDOW | digitalvideo, sobreposição | Controla a janela de exibição. |