ACMDRIVERDETAILS-Struktur (msacm.h)

Artikel
08/24/2023

Die ACMDRIVERDETAILS-Struktur beschreibt die Features eines ACM-Treibers.

Syntax

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

Größe der gültigen Informationen in Byte, die in der ACMDRIVERDETAILS-Struktur enthalten sind. Eine Anwendung sollte diesen Member auf die Größe der gewünschten Informationen in Bytes initialisieren. Die in diesem Member angegebene Größe muss groß genug sein, um den cbStruct-Member der ACMDRIVERDETAILS-Struktur zu enthalten. Wenn die acmDriverDetails-Funktion zurückgibt, enthält dieses Element die tatsächliche Größe der zurückgegebenen Informationen. Die zurückgegebenen Informationen überschreiten niemals die angeforderte Größe.

fccType

Typ des Treibers. Legen Sie für ACM-Treiber dieses Element auf ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC fest.

fccComp

Untertyp des Treibers. Dieser Member ist derzeit auf ACMDRIVERDETAILS_FCCCOMP_UNDEFINED (null) festgelegt.

wMid

Hersteller-ID. Hersteller-IDs werden unter Hersteller- und Produkt-IDs definiert.

wPid

Produktbezeichner. Produktbezeichner werden unter Hersteller- und Produkt-IDs definiert.

vdwACM

Version des ACM, für das dieser Treiber kompiliert wurde. Die Versionsnummer ist eine Hexadezimalzahl im Format 0xAABBCCCC, wobei AA die Hauptversionsnummer, BB die Nebenversionsnummer und CCCC die Buildnummer ist. Die Versionsteile (Hauptversion, Nebenversion und Build) sollten als Dezimalzahlen angezeigt werden.

vdwDriver

Version des Treibers. Die Versionsnummer ist eine Hexadezimalzahl im Format 0xAABBCCCC, wobei AA die Hauptversionsnummer, BB die Nebenversionsnummer und CCCC die Buildnummer ist. Die Versionsteile (Hauptversion, Nebenversion und Build) sollten als Dezimalzahlen angezeigt werden.

fdwSupport

Unterstützungsflags für den Treiber. Die folgenden Werte werden definiert:

Name	BESCHREIBUNG
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Der Treiber unterstützt asynchrone Konvertierungen.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formattags. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten desselben Formattags. Wenn z. B. ein Treiber das ErneutesAmpling von WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_DISABLED	Der Treiber wurde deaktiviert. Dieses Flag wird vom ACM für einen Treiber festgelegt, wenn es aus verschiedenen Gründen deaktiviert wurde. Deaktivierte Treiber können nicht geöffnet werden und können nur unter sehr begrenzten Umständen verwendet werden.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Der Treiber unterstützt einen Filter (Änderung der Daten ohne Änderung der Formatattribute). Wenn ein Treiber beispielsweise Volume- oder Echovorgänge für WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Der Treiber unterstützt Hardwareeingaben, -ausgaben oder beides über ein Waveform-Audio-Gerät. Eine Anwendung sollte die acmMetrics-Funktion mit den ACM_METRIC_HARDWARE_WAVE_INPUT und ACM_METRIC_HARDWARE_WAVE_OUTPUT Metrikindizes verwenden, um die dem unterstützenden ACM-Treiber zugeordneten Waveform-Audio-Gerätebezeichner abzurufen.
ACMDRIVERDETAILS_SUPPORTF_LOCAL	Der Treiber wurde in Bezug auf die aktuelle Aufgabe lokal installiert.

cFormatTags

Anzahl eindeutiger Formattags, die von diesem Treiber unterstützt werden.

cFilterTags

Anzahl der eindeutigen Filtertags, die von diesem Treiber unterstützt werden.

hicon

Handle zu einem benutzerdefinierten Symbol für diesen Treiber. Eine Anwendung kann dieses Symbol verwenden, um visuell auf den Treiber zu verweisen. Dieser Member kann NULL sein.

szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]

Null-beendete Zeichenfolge, die den Namen des Treibers beschreibt. Diese Zeichenfolge soll in kleinen Abständen angezeigt werden.

szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]

Null-terminierte Zeichenfolge, die den vollständigen Namen des Treibers beschreibt. Diese Zeichenfolge soll in großen (beschreibenden) Bereichen angezeigt werden.

szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]

Null-terminierte Zeichenfolge, die Copyrightinformationen für den Treiber bereitstellt.

szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]

Null-beendete Zeichenfolge, die spezielle Lizenzierungsinformationen für den Treiber bereitstellt.

szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]

Null-terminierte Zeichenfolge, die spezielle Featureinformationen für den Treiber bereitstellt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	msacm.h

Weitere Informationen

Audiokomprimierungs-Manager

Audiokomprimierungsstrukturen

acmDriverDetails

acmMetrics