Структура ACMDRIVERDETAILS (msacm.h)
Структура ACMDRIVERDETAILS описывает функции драйвера ACM.
Синтаксис
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;
Члены
cbStruct
Размер (в байтах) допустимой информации, содержащейся в структуре ACMDRIVERDETAILS . Приложение должно инициализировать этот элемент размером требуемых сведений в байтах. Размер, указанный в этом элементе, должен быть достаточно большим, чтобы содержать элемент cbStruct структуры ACMDRIVERDETAILS . При возвращении функции acmDriverDetails этот элемент содержит фактический размер возвращаемых сведений. Возвращаемые сведения никогда не будут превышать запрошенный размер.
fccType
Тип драйвера. Для драйверов ACM задайте для этого элемента значение ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC.
fccComp
Подтип драйвера. В настоящее время для этого элемента задано значение ACMDRIVERDETAILS_FCCCOMP_UNDEFINED (ноль).
wMid
Идентификатор производителя. Идентификаторы изготовителей определяются в полях Идентификаторы производителя и Продукта.
wPid
Идентификатор продукта. Идентификаторы продуктов определяются в полях "Изготовитель" и "Идентификаторы продуктов".
vdwACM
Версия ACM, для которой был скомпилирован этот драйвер. Номер версии — это шестнадцатеричное число в формате 0xAABBCCCC, где AA — основной номер версии, BB — дополнительный номер версии, а CCCC — номер сборки. Части версии (основной, дополнительный и сборка) должны отображаться в виде десятичных чисел.
vdwDriver
Версия драйвера. Номер версии — это шестнадцатеричное число в формате 0xAABBCCCC, где AA — основной номер версии, BB — дополнительный номер версии, а CCCC — номер сборки. Части версии (основной, дополнительный и сборка) должны отображаться в виде десятичных чисел.
fdwSupport
Флаги поддержки для драйвера. Определяются следующие значения:
| Имя | Описание |
|---|---|
|
Драйвер поддерживает асинхронные преобразования. |
|
Драйвер поддерживает преобразование между двумя различными тегами формата. Например, если драйвер поддерживает сжатие от WAVE_FORMAT_PCM до WAVE_FORMAT_ADPCM, этот флаг устанавливается. |
|
Драйвер поддерживает преобразование двух разных форматов одного и того же тега формата. Например, если драйвер поддерживает повторную выборку WAVE_FORMAT_PCM, этот флаг устанавливается. |
|
Драйвер отключен. Этот флаг устанавливается ACM для драйвера, если он был отключен по ряду причин. Отключенные драйверы не могут быть открыты и могут использоваться только в очень ограниченных обстоятельствах. |
|
Драйвер поддерживает фильтр (изменение данных без изменения атрибутов формата). Например, если драйвер поддерживает операции тома или эха в WAVE_FORMAT_PCM, этот флаг устанавливается. |
|
Драйвер поддерживает аппаратные входные и выходные данные через устройство waveform-audio. Приложение должно использовать функцию acmMetrics с ACM_METRIC_HARDWARE_WAVE_INPUT и ACM_METRIC_HARDWARE_WAVE_OUTPUT индексами метрик, чтобы получить идентификаторы устройства waveform-audio, связанные с поддерживающим драйвером ACM. |
|
Драйвер установлен локально по отношению к текущей задаче. |
cFormatTags
Количество тегов уникального формата, поддерживаемых этим драйвером.
cFilterTags
Количество уникальных тегов фильтра, поддерживаемых этим драйвером.
hicon
Дескриптор настраиваемого значка для этого драйвера. Приложение может использовать этот значок для визуальной ссылки на драйвер. Этот элемент может иметь значение NULL.
szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]
Строка, завершающаяся значением NULL, описывающая имя драйвера. Эта строка предназначена для отображения в небольших пространствах.
szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]
Строка, завершающаяся значением NULL, описывающая полное имя драйвера. Эта строка должна отображаться в больших (описательных) пространствах.
szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]
Строка, завершающаяся значением NULL, которая предоставляет сведения об авторских правах для драйвера.
szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]
Строка со значением NULL, которая предоставляет специальные сведения о лицензировании для драйвера.
szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]
Строка, завершающаяся значением NULL, которая предоставляет специальные сведения о функциях для драйвера.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | msacm.h |