comando MCI_INFO

O comando MCI_INFO recupera informações de cadeia de caracteres de um dispositivo. Todos os dispositivos reconhecem esse comando. As informações são retornadas no membro lpstrReturn da estrutura identificada por lpInfo. O membro dwRetSize especifica o comprimento do buffer para os dados retornados.

Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_INFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_INFO_PARMS) lpInfo
);

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.

lpInfo

Ponteiro para uma estrutura MCI_INFO_PARMS . (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

O seguinte sinalizador padrão e específico de comando adicional se aplica a todos os dispositivos que dão suporte a MCI_INFO:

MCI_INFO_PRODUCT

Obtém uma descrição do hardware associado a um dispositivo. Os dispositivos devem fornecer uma descrição que identifique o driver e o hardware usado.

Os seguintes sinalizadores adicionais se aplicam ao tipo de dispositivo cdaudio :

MCI_INFO_MEDIA_IDENTITY

Produz um identificador exclusivo para o CD de áudio atualmente carregado no player que está sendo consultado. Esse sinalizador retorna uma cadeia de caracteres de 16 dígitos hexadecimais.

MCI_INFO_MEDIA_UPC

Produz o UPC (Código universal do produto) codificado em um CD de áudio. O UPC é uma cadeia de caracteres de dígitos. Ele pode não estar disponível para todos os CDs.

Os seguintes sinalizadores adicionais se aplicam ao tipo de dispositivo digitalvideo :

MCI_DGV_INFO_ITEM

Uma constante que indica as informações desejadas está incluída no membro dwItem da estrutura identificada por lpInfo. As seguintes constantes são definidas para dispositivos de vídeo digital:

MCI_DGV_INFO_AUDIO_ALG

Retorna o nome do algoritmo de compactação de áudio atual.

MCI_DGV_INFO_AUDIO_QUALITY

Retorna o nome do descritor de qualidade de áudio atual.

MCI_DGV_INFO_STILL_ALG

Retorna o nome do algoritmo de compactação de imagem ainda atual.

MCI_DGV_INFO_STILL_QUALITY

Retorna o nome do descritor de qualidade de imagem ainda atual.

MCI_DGV_INFO_USAGE

Retorna uma cadeia de caracteres que descreve restrições de uso que podem ser impostas pelo proprietário dos dados visuais ou audíveis no workspace.

MCI_DGV_INFO_VIDEO_ALG

Retorna o nome do algoritmo de compactação de vídeo atual.

MCI_DGV_INFO_VIDEO_QUALITY

Retorna o nome do descritor de qualidade de vídeo atual.

MCI_INFO_VERSION

Retorna o nível de versão do driver e do hardware do dispositivo. Os desenvolvedores de driver de dispositivo devem documentar a sintaxe da cadeia de caracteres retornada.

MCI_DGV_INFO_TEXT

Obtém a janela legenda.

MCI_INFO_FILE

Obtém o caminho e o nome do arquivo do último arquivo especificado com o comando MCI_OPEN ou MCI_LOAD . Se um arquivo não tiver sido especificado, o dispositivo retornará uma cadeia de caracteres terminada em nulo. Esse sinalizador só tem suporte de dispositivos que retornam TRUE para o sinalizador MCI_GETDEVCAPS_USES_FILES do comando MCI_GETDEVCAPS .

Para dispositivos de vídeo digital, lpInfo aponta para uma estrutura MCI_DGV_INFO_PARMS .

Os seguintes sinalizadores adicionais se aplicam ao tipo de dispositivo sequenciador :

MCI_INFO_COPYRIGHT

Obtém o aviso de direitos autorais do arquivo MIDI do meta evento de direitos autorais.

MCI_INFO_FILE

Obtém o nome do arquivo atual. Esse sinalizador só tem suporte de dispositivos que retornam TRUE quando você chama o comando MCI_GETDEVCAPS com o sinalizador MCI_GETDEVCAPS_USES_FILES.

MCI_INFO_NAME

Obtém o nome da sequência do meta evento sequence/track name.

O seguinte sinalizador adicional se aplica ao tipo de dispositivo vcr :

MCI_VCR_INFO_VERSION

Define o membro lpstrReturn da estrutura MCI_INFO_PARMS para apontar para o número de versão. Também define o membro dwRetSize igual ao comprimento da cadeia de caracteres apontada.

Os seguintes sinalizadores adicionais se aplicam ao tipo de dispositivo de sobreposição :

MCI_INFO_FILE

Obtém o nome do arquivo atual. Esse sinalizador só tem suporte de dispositivos que retornam TRUE para o sinalizador MCI_GETDEVCAPS_USES_FILES do comando MCI_GETDEVCAPS .

MCI_OVLY_INFO_TEXT

Obtém o legenda da janela associada ao dispositivo de sobreposição de vídeo.

Os seguintes sinalizadores adicionais se aplicam ao tipo de dispositivo waveaudio :

MCI_INFO_FILE

Obtém o nome do arquivo atual. Esse sinalizador é compatível com dispositivos que retornam TRUE quando você chama o comando MCI_GETDEVCAPS com o sinalizador MCI_GETDEVCAPS_USES_FILES.

MCI_WAVE_INPUT

Obtém o nome do produto da entrada atual.

MCI_WAVE_OUTPUT

Obtém o nome do produto da saída atual e seu valor é específico do dispositivo.

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

Confira também

MCI

Comandos MCI