Comando MCI_LIST
O comando MCI_LIST obtém informações sobre o número e os tipos de entradas disponíveis para o dispositivo. Os dispositivos de vídeo digital e videocassete reconhecem esse comando.
Para enviar esse comando, chame a função mciSendCommand com os seguintes parâmetros.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_LIST,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpList
);
Parâmetros
-
wDeviceID
-
Identificador do dispositivo MCI que deve receber a mensagem de comando.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os sinalizadores Wait, Notify e Test.
-
lpList
-
Ponteiro para uma estrutura MCI_GENERIC_PARMS. (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)
Valor de retorno
Retornará zero se tiver êxito; caso contrário, retornará um erro.
Comentários
Os seguintes sinalizadores adicionais se aplicam ao tipo de dispositivo digitalvideo:
-
MCI_DGV_LIST_ALG
-
O membro lpstrAlgorithm da estrutura identificada por IpList contém um endereço de um buffer contendo o nome de um algoritmo. O nome é usado para recuperar os tipos de descritores de qualidade associados a um algoritmo.
-
MCI_DGV_LIST_COUNT
-
Retorna o número de opções do tipo especificado.
-
MCI_DGV_LIST_ITEM
-
Uma constante que indica o tipo de lista é incluída no membro dwItem da estrutura identificada por IpList. Este sinalizador é necessário. Use uma das seguintes constantes para indicar o tipo de lista:
-
MCI_DGV_LIST_AUDIO_ALG
-
O comando deve recuperar nomes de algoritmos de áudio.
-
MCI_DGV_LIST_AUDIO_QUALITY
-
O comando deve recuperar níveis de qualidade de áudio. Os níveis retornados são associados ao algoritmo referenciado pelo membro lpstrAlgorithm da estrutura identificada por IpList. Se esse membro for especificado usando a cadeia de caracteres “current”, as qualidades associadas ao algoritmo atual serão retornadas.
-
MCI_DGV_LIST_AUDIO_STREAM
-
O comando deve recuperar nomes de fluxos de áudio.
-
MCI_DGV_LIST_STILL_AL
-
O comando deve recuperar nomes de algoritmos estáticos.
-
MCI_DGV_LIST_STILL_QUALITY
-
O comando deve recuperar níveis de qualidade. Os níveis retornados são associados ao algoritmo referenciado pelo membro lpstrAlgorithm da estrutura identificada por IpList. Se esse membro for especificado usando a cadeia de caracteres “current”, as qualidades associadas ao algoritmo atual serão retornadas.
-
MCI_DGV_LIST_VIDEO_ALG
-
O comando deve recuperar nomes de algoritmos de vídeo.
-
MCI_DGV_LIST_VIDEO_QUALITY
-
O comando deve recuperar níveis de qualidade de vídeo. Os níveis retornados são associados ao algoritmo referenciado pelo membro lpstrAlgorithm da estrutura identificada por IpList. Se esse membro for especificado usando a cadeia de caracteres “current”, as qualidades associadas ao algoritmo atual serão retornadas.
-
MCI_DGV_LIST_VIDEO_SOURCE
-
O comando deve retornar informações sobre as fontes de vídeo. Quando usado com MCI_DGV_LIST_COUNT, o comando retorna o número de fontes de vídeo. Quando usado com MCI_DGV_LIST_NUMBER, o comando retorna o tipo de uma fonte de vídeo. MCI define os seguintes tipos:
- MCI_DGV_SETVIDEO_SRC_GENERIC
- MCI_DGV_SETVIDEO_SRC_NTSC
- MCI_DGV_SETVIDEO_SRC_PAL
- MCI_DGV_SETVIDEO_SRC_RGB
- MCI_DGV_SETVIDEO_SRC_SECAM
- MCI_DGV_SETVIDEO_SRC_SVIDEO
Pode haver mais de uma fonte de cada tipo retornado. O tipo de fonte genérica é usado quando mais de um tipo de sinal é permitido para esse conector.
-
MCI_DGV_LIST_VIDEO_STREAM
-
O comando deve recuperar nomes de fluxos de vídeo.
-
MCI_DGV_LIST_NUMBER
-
Um índice é especificado no membro dwNumber da estrutura identificada por IpList. O índice deve ser um inteiro entre 1 e o valor retornado para o sinalizador MCI_DGV_LIST_COUNT.
Para dispositivos de vídeo digital, IpList aponta para uma estrutura MCI_DGV_LIST_PARMS.
Os seguintes sinalizadores adicionais se aplicam ao tipo de dispositivo vcr:
-
MCI_VCR_LIST_AUDIO_SOURCE
-
Listar entradas ou tipos de áudio.
-
MCI_VCR_LIST_COUNT
-
Define o membro dwReturn da estrutura identificada por IpList como o número total de entradas de vídeo ou áudio.
-
MCI_VCR_LIST_NUMBER
-
Define o membro dwReturn da estrutura identificada por IpList como o tipo de entrada de vídeo ou áudio especificado pelo membro dwNumber.
-
MCI_VCR_LIST_VIDEO_SOURCE
-
Listar entradas ou tipos de vídeo.
Para dispositivos de videocassete, IpList aponta para uma estrutura MCI_VCR_LIST_PARMS.
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 |
|