Estrutura ACMDRIVERDETAILS (msacm.h)
A estrutura ACMDRIVERDETAILS descreve os recursos de um driver ACM.
Sintaxe
typedef struct tACMDRIVERDETAILS {
DWORD cbStruct;
FOURCC fccType;
FOURCC fccComp;
WORD wMid;
WORD wPid;
DWORD vdwACM;
DWORD vdwDriver;
DWORD fdwSupport;
DWORD cFormatTags;
DWORD cFilterTags;
HICON hicon;
char szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS];
char szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS];
char szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS];
char szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS];
char szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS];
} ACMDRIVERDETAILS, *PACMDRIVERDETAILS, *LPACMDRIVERDETAILS;
Membros
cbStruct
Tamanho, em bytes, das informações válidas contidas na estrutura ACMDRIVERDETAILS . Um aplicativo deve inicializar esse membro para o tamanho, em bytes, das informações desejadas. O tamanho especificado neste membro deve ser grande o suficiente para conter o membro cbStruct da estrutura ACMDRIVERDETAILS . Quando a função acmDriverDetails retorna, esse membro contém o tamanho real das informações retornadas. As informações retornadas nunca excederão o tamanho solicitado.
fccType
Tipo do driver. Para drivers ACM, defina esse membro como ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC.
fccComp
Subtipo do driver. No momento, esse membro está definido como ACMDRIVERDETAILS_FCCCOMP_UNDEFINED (zero).
wMid
Identificador do fabricante. Os identificadores do fabricante são definidos em Identificadores de Fabricante e Produto.
wPid
Identificador do produto. Os identificadores de produto são definidos em Identificadores de Produto e Fabricante.
vdwACM
Versão do ACM para o qual esse driver foi compilado. O número de versão é um número hexadecimal no formato 0xAABBCCCC, em que AA é o número de versão principal, BB é o número de versão secundária e CCCC é o número de build. As partes de versão (principal, secundária e build) devem ser exibidas como números decimais.
vdwDriver
Versão do driver. O número de versão é um número hexadecimal no formato 0xAABBCCCC, em que AA é o número de versão principal, BB é o número de versão secundária e CCCC é o número de build. As partes de versão (principal, secundária e build) devem ser exibidas como números decimais.
fdwSupport
Sinalizadores de suporte para o driver. Os seguintes valores são definidos:
| Nome | Descrição |
|---|---|
|
O driver dá suporte a conversões assíncronas. |
|
O driver dá suporte à conversão entre duas marcas de formato diferentes. Por exemplo, se um driver der suporte à compactação de WAVE_FORMAT_PCM para WAVE_FORMAT_ADPCM, esse sinalizador será definido. |
|
O driver dá suporte à conversão entre dois formatos diferentes da mesma marca de formato. Por exemplo, se um driver der suporte à reexame de WAVE_FORMAT_PCM, esse sinalizador será definido. |
|
O driver foi desabilitado. Esse sinalizador é definido pelo ACM para um driver quando ele foi desabilitado por vários motivos. Os drivers desabilitados não podem ser abertos e só podem ser usados em circunstâncias muito limitadas. |
|
O driver dá suporte a um filtro (modificação dos dados sem alterar nenhum dos atributos de formato). Por exemplo, se um driver der suporte a operações de volume ou eco em WAVE_FORMAT_PCM, esse sinalizador será definido. |
|
O driver dá suporte à entrada, saída ou ambos por meio de um dispositivo de áudio waveform. Um aplicativo deve usar a função acmMetrics com os índices de métrica ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT para obter os identificadores de dispositivo waveform-audio associados ao driver ACM de suporte. |
|
O driver foi instalado localmente em relação à tarefa atual. |
cFormatTags
Número de marcas de formato exclusivas compatíveis com esse driver.
cFilterTags
Número de marcas de filtro exclusivas compatíveis com esse driver.
hicon
Manipule para um ícone personalizado para este driver. Um aplicativo pode usar esse ícone para referenciar o driver visualmente. Esse membro pode ser NULL.
szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]
Cadeia de caracteres terminada em nulo que descreve o nome do driver. Essa cadeia de caracteres deve ser exibida em espaços pequenos.
szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]
Cadeia de caracteres terminada em nulo que descreve o nome completo do driver. Essa cadeia de caracteres deve ser exibida em espaços grandes (descritivos).
szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]
Cadeia de caracteres terminada em nulo que fornece informações de direitos autorais para o driver.
szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]
Cadeia de caracteres terminada em nulo que fornece informações especiais de licenciamento para o driver.
szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]
Cadeia de caracteres terminada em nulo que fornece informações especiais de recurso para o driver.
Requisitos
| 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 | msacm.h |
Confira também
Gerenciador de Compactação de Áudio