ACMDRIVERDETAILS-Struktur (msacm.h)
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 |
|---|---|
|
Der Treiber unterstützt asynchrone Konvertierungen. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |