Compartir a través de


Estructura ACMDRIVERDETAILS (msacm.h)

La estructura ACMDRIVERDETAILS describe las características de un controlador ACM.

Sintaxis

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;

Members

cbStruct

Tamaño, en bytes, de la información válida contenida en la estructura ACMDRIVERDETAILS . Una aplicación debe inicializar este miembro al tamaño, en bytes, de la información deseada. El tamaño especificado en este miembro debe ser lo suficientemente grande como para contener el miembro cbStruct de la estructura ACMDRIVERDETAILS . Cuando la función acmDriverDetails devuelve, este miembro contiene el tamaño real de la información devuelta. La información devuelta nunca superará el tamaño solicitado.

fccType

Tipo del controlador. Para los controladores de ACM, establezca este miembro en ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC.

fccComp

Subtipo del controlador. Este miembro está establecido actualmente en ACMDRIVERDETAILS_FCCCOMP_UNDEFINED (cero).

wMid

Identificador del fabricante. Los identificadores de fabricante se definen en Identificadores de fabricante y producto.

wPid

Identificador de producto. Los identificadores de producto se definen en Fabricante e Identificadores de Producto.

vdwACM

Versión de ACM para la que se compiló este controlador. El número de versión es un número hexadecimal en el formato 0xAABBCCCC, donde AA es el número de versión principal, BB es el número de versión secundaria y CCCC es el número de compilación. Las partes de versión (principal, secundaria y compilación) deben mostrarse como números decimales.

vdwDriver

Versión del controlador. El número de versión es un número hexadecimal en el formato 0xAABBCCCC, donde AA es el número de versión principal, BB es el número de versión secundaria y CCCC es el número de compilación. Las partes de versión (principal, secundaria y compilación) deben mostrarse como números decimales.

fdwSupport

Marcas de compatibilidad para el controlador. Se definen los valores siguientes:

Nombre Descripción
ACMDRIVERDETAILS_SUPPORTF_ASYNC
El controlador admite conversiones asincrónicas.
ACMDRIVERDETAILS_SUPPORTF_CODEC
El controlador admite la conversión entre dos etiquetas de formato diferentes. Por ejemplo, si un controlador admite la compresión de WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM, se establece esta marca.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER
El controlador admite la conversión entre dos formatos diferentes de la misma etiqueta de formato. Por ejemplo, si un controlador admite el muestreo de WAVE_FORMAT_PCM, se establece esta marca.
ACMDRIVERDETAILS_SUPPORTF_DISABLED
El controlador se ha deshabilitado. El ACM establece esta marca para un controlador cuando se ha deshabilitado por cualquiera de los motivos. Los controladores deshabilitados no se pueden abrir y solo se pueden usar en circunstancias muy limitadas.
ACMDRIVERDETAILS_SUPPORTF_FILTER
El controlador admite un filtro (modificación de los datos sin cambiar ninguno de los atributos de formato). Por ejemplo, si un controlador admite operaciones de volumen o eco en WAVE_FORMAT_PCM, se establece esta marca.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE
El controlador admite la entrada de hardware, la salida o ambos a través de un dispositivo de audio de forma de onda. Una aplicación debe usar la función acmMetrics con los índices de métricas de ACM_METRIC_HARDWARE_WAVE_INPUT y ACM_METRIC_HARDWARE_WAVE_OUTPUT para obtener los identificadores de dispositivo de audio de forma de onda asociados al controlador ACM compatible.
ACMDRIVERDETAILS_SUPPORTF_LOCAL
El controlador se ha instalado localmente con respecto a la tarea actual.

cFormatTags

Número de etiquetas de formato únicas admitidas por este controlador.

cFilterTags

Número de etiquetas de filtro únicas admitidas por este controlador.

hicon

Controle un icono personalizado para este controlador. Una aplicación puede usar este icono para hacer referencia visualmente al controlador. Este miembro puede ser NULL.

szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]

Cadena terminada en NULL que describe el nombre del controlador. Esta cadena está pensada para mostrarse en espacios pequeños.

szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]

Cadena terminada en NULL que describe el nombre completo del controlador. Esta cadena está pensada para mostrarse en espacios grandes (descriptivos).

szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]

Cadena terminada en null que proporciona información de copyright para el controlador.

szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]

Cadena terminada en null que proporciona información especial de licencia para el controlador.

szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]

Cadena terminada en NULL que proporciona información especial de características para el controlador.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado msacm.h

Consulte también

Administrador de compresión de audio

Estructuras de compresión de audio

acmDriverDetails

acmMetrics