comando MCI_GETDEVCAPS
O comando MCI_GETDEVCAPS recupera informações estáticas sobre um dispositivo. Todos os dispositivos reconhecem esse comando. Os parâmetros e sinalizadores disponíveis para esse comando dependem do dispositivo selecionado. As informações são retornadas no membro dwReturn da estrutura identificada por lpCapsParms.
Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_GETDEVCAPS,
DWORD dwFlags,
(DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);
Parâmetros
-
wDeviceID
-
Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT ou, para dispositivos de vídeo digital e VCR, MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.
-
lpCapsParms
-
Ponteiro para uma estrutura MCI_GETDEVCAPS_PARMS .
Valor Retornado
Retornará zero se tiver êxito ou um erro, caso contrário.
Comentários
Os seguintes sinalizadores padrão e específicos de comando adicionais se aplicam a todos os dispositivos que dão suporte a MCI_GETDEVCAPS:
-
MCI_GETDEVCAPS_COMPOUND_DEVICE
-
O membro dwReturn será definido como TRUE se o dispositivo usar o armazenamento de dados que deve ser aberto e fechado explicitamente; ele será definido como FALSE caso contrário.
-
MCI_GETDEVCAPS_DEVICE_TYPE
-
O membro dwReturn é definido como um dos valores listados em Tipos de Dispositivo MCI.
-
MCI_GETDEVCAPS_HAS_AUDIO
-
O membro dwReturn será definido como TRUE se o dispositivo tiver saída de áudio; ele será definido como FALSE caso contrário.
-
MCI_GETDEVCAPS_HAS_VIDEO
-
O membro dwReturn será definido como TRUE se o dispositivo tiver saída de vídeo; ele será definido como FALSE caso contrário. Por exemplo, o membro é definido como TRUE para dispositivos que dão suporte ao conjunto de comandos videodisc.
-
MCI_GETDEVCAPS_ITEM
-
Especifica que o membro dwItem da estrutura MCI_GETDEVCAPS_PARMS contém uma das seguintes constantes:
-
MCI_GETDEVCAPS_CAN_EJECT
-
O membro dwReturn será definido como TRUE se o dispositivo puder ejetar a mídia; caso contrário, ele será definido como FALSE.
-
MCI_GETDEVCAPS_CAN_PLAY
-
O membro dwReturn será definido como TRUE se o dispositivo puder reproduzir a mídia; caso contrário, ele será definido como FALSE. Se um dispositivo especificar TRUE, isso implicará que o dispositivo dá suporte aos comandos MCI_PAUSE e MCI_STOP , bem como ao comando MCI_PLAY .
-
MCI_GETDEVCAPS_CAN_RECORD
-
O membro dwReturn será definido como TRUE se o dispositivo der suporte à gravação; caso contrário, ele será definido como FALSE. Se um dispositivo especificar TRUE, isso implicará que o dispositivo dá suporte aos comandos MCI_PAUSE e MCI_STOP, bem como ao comando MCI_RECORD .
-
MCI_GETDEVCAPS_CAN_SAVE
-
O membro dwReturn será definido como TRUE se o dispositivo puder salvar um arquivo; caso contrário, ele será definido como FALSE.
-
MCI_GETDEVCAPS_USES_FILES
-
O membro dwReturn será definido como TRUE se o dispositivo exigir um nome de arquivo; ele será definido como FALSE caso contrário. Somente dispositivos compostos usam arquivos.
Os seguintes sinalizadores podem ser especificados no membro dwItem do MCI_GETDEVCAPS_PARMS para o tipo de dispositivo digitalvideo :
-
MCI_DGV_GETDEVCAPS_CAN_FREEZE
-
O membro dwReturn será definido como TRUE se o dispositivo puder congelar quadros; caso contrário, ele será definido como FALSE.
-
MCI_DGV_GETDEVCAPS_CAN_LOCK
-
O membro dwReturn será definido como TRUE se o dispositivo puder bloquear; caso contrário, ele será definido como FALSE.
-
MCI_DGV_GETDEVCAPS_CAN_REVERSE
-
O membro dwReturn será definido como TRUE se o dispositivo puder ser reproduzido ao contrário; caso contrário, ele será definido como FALSE.
-
MCI_DGV_GETDEVCAPS_CAN_STR_IN
-
O membro dwReturn será definido como TRUE se o dispositivo puder ampliar a entrada; caso contrário, ele será definido como FALSE.
-
MCI_DGV_GETDEVCAPS_CAN_STRETCH
-
O membro dwReturn será definido como TRUE se o dispositivo puder esticar uma imagem; caso contrário, ele será definido como FALSE.
-
MCI_DGV_GETDEVCAPS_CAN_TEST
-
O membro dwReturn será definido como TRUE se o dispositivo puder executar testes; caso contrário, ele será definido como FALSE.
-
MCI_DGV_GETDEVCAPS_HAS_STILL
-
O membro dwReturn será definido como TRUE se o dispositivo puder exibir imagens paradas; caso contrário, ele será definido como FALSE.
-
MCI_DGV_GETDEVCAPS_MAX_WINDOWS
-
O membro dwReturn é definido como o número máximo de janelas que o dispositivo pode manipular simultaneamente.
-
MCI_DGV_GETDEVCAPS_MAXIMUM_RATE
-
O membro dwReturn é definido como a taxa de reprodução máxima para o dispositivo, em quadros por segundo.
-
MCI_DGV_GETDEVCAPS_MINIMUM_RATE
-
O membro dwReturn é definido como a taxa mínima de reprodução para o dispositivo, em quadros por segundo.
-
MCI_DGV_GETDEVCAPS_PALETTES
-
O membro dwReturn será definido como TRUE se o dispositivo puder retornar um identificador de paleta; caso contrário, ele será definido como FALSE.
Os seguintes sinalizadores podem ser especificados no membro dwItem do MCI_GETDEVCAPS_PARMS para o tipo de dispositivo vcr :
-
MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE
-
O membro dwReturn é definido como o número de incrementos por segundo.
-
MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH
-
O membro dwReturn será definido como TRUE se o dispositivo for capaz de detectar o comprimento da mídia; caso contrário, ele será definido como FALSE.
-
MCI_VCR_GETDEVCAPS_CAN_FREEZE
-
O membro dwReturn será definido como TRUE se o dispositivo for capaz de congelar a imagem de saída; caso contrário, ele será definido como FALSE.
-
MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES
-
O membro dwReturn será definido como TRUE se o dispositivo for capaz de monitorar fontes; caso contrário, ele será definido como FALSE.
-
MCI_VCR_GETDEVCAPS_CAN_PREROLL
-
O membro dwReturn será definido como TRUE se o dispositivo for capaz de pré-registrar; caso contrário, ele será definido como FALSE.
-
MCI_VCR_GETDEVCAPS_CAN_PREVIEW
-
O membro dwReturn será definido como TRUE se o dispositivo for capaz de visualizações; caso contrário, ele será definido como FALSE.
-
MCI_VCR_GETDEVCAPS_CAN_REVERSE
-
O membro dwReturn será definido como TRUE se o dispositivo for capaz de ser reproduzido ao contrário; caso contrário, ele será definido como FALSE.
-
MCI_VCR_GETDEVCAPS_CAN_TEST
-
O membro dwReturn será definido como TRUE se o dispositivo for capaz de testar; caso contrário, ele será definido como FALSE.
-
MCI_VCR_GETDEVCAPS_HAS_CLOCK
-
O membro dwReturn será definido como TRUE se o dispositivo der suporte a um relógio externo; caso contrário, ele será definido como FALSE.
-
MCI_VCR_GETDEVCAPS_HAS_TIMECODE
-
O membro dwReturn será definido como TRUE se o dispositivo tiver capacidade de código de tempo ou se essa funcionalidade for desconhecida; caso contrário, ele será definido como FALSE.
-
MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS
-
O membro dwReturn é definido como o número de marcas (99).
-
MCI_VCR_GETDEVCAPS_SEEK_ACCURACY
-
O membro dwReturn é definido como a precisão de busca do dispositivo.
Os seguintes sinalizadores podem ser especificados no membro dwItem do MCI_GETDEVCAPS_PARMS para o tipo de dispositivo de sobreposição :
-
MCI_OVLY_GETDEVCAPS_CAN_FREEZE
-
O membro dwReturn será definido como TRUE se o dispositivo puder congelar a imagem; caso contrário, ele será definido como FALSE.
-
MCI_OVLY_GETDEVCAPS_CAN_STRETCH
-
O membro dwReturn será definido como TRUE se o dispositivo puder esticar a imagem para preencher o quadro; caso contrário, ele será definido como FALSE.
-
MCI_OVLY_GETDEVCAPS_MAX_WINDOWS
-
O membro dwReturn é definido como o número máximo de janelas que o dispositivo pode manipular simultaneamente.
Os seguintes sinalizadores podem ser especificados no membro dwItem de MCI_GETDEVCAPS_PARMS para o tipo de dispositivo videodisc :
-
MCI_VD_GETDEVCAPS_CAN_REVERSE
-
O membro dwReturn será definido como TRUE se o player de videodisc puder ser reproduzido inverso; caso contrário, ele será definido como FALSE. Alguns jogadores podem reproduzir discos CLV ao contrário, bem como discos CAV.
-
MCI_VD_GETDEVCAPS_CAV
-
Quando combinado com outros itens, especifica que as informações de retorno se aplicam aos videodiscs de formato CAV. Esse é o padrão se nenhum videodisc for inserido.
-
MCI_VD_GETDEVCAPS_CLV
-
Quando combinado com outros itens, especifica que as informações de retorno se aplicam aos videodiscs de formato CLV.
-
MCI_VD_GETDEVCAPS_FAST_RATE
-
O membro dwReturn é definido como a taxa de reprodução rápida padrão em quadros por segundo.
-
MCI_VD_GETDEVCAPS_NORMAL_RATE
-
O membro dwReturn é definido como a taxa de reprodução normal em quadros por segundo.
-
MCI_VD_GETDEVCAPS_SLOW_RATE
-
O membro dwReturn é definido como a taxa de reprodução lenta padrão em quadros por segundo.
Os sinalizadores a seguir podem ser especificados no membro dwItem de MCI_GETDEVCAPS_PARMS para o tipo de dispositivo waveaudio :
-
MCI_WAVE_GETDEVCAPS_INPUT
-
O membro dwReturn é definido como o número total de dispositivos de entrada de forma de onda (gravação).
-
MCI_WAVE_GETDEVCAPS_OUTPUT
-
O membro dwReturn é definido como o número total de dispositivos de saída de forma de onda (reproduçã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] |
| Cabeçalho |
|