ACMFILTERTAGDETAILS-Struktur (msacm.h)

  • Artikel

Die ACMFILTERTAGDETAILS-Struktur enthält Details zu einem Waveform-Audio-Filtertag für einen ACM-Filtertreiber.

Syntax

typedef struct tACMFILTERTAGDETAILS {
  DWORD cbStruct;
  DWORD dwFilterTagIndex;
  DWORD dwFilterTag;
  DWORD cbFilterSize;
  DWORD fdwSupport;
  DWORD cStandardFilters;
  char  szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
} ACMFILTERTAGDETAILS, *PACMFILTERTAGDETAILS, *LPACMFILTERTAGDETAILS;

Members

cbStruct

Größe der ACMFILTERTAGDETAILS-Struktur in Byte. Dieser Member muss initialisiert werden, bevor eine Anwendung die Funktion acmFilterTagDetails oder acmFilterTagEnum aufruft. Die in diesem Member angegebene Größe muss groß genug sein, um die ACMFILTERTAGDETAILS-Basisstruktur zu enthalten. Wenn die acmFilterTagDetails-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.

dwFilterTagIndex

Index des Filtertags, für das Details abgerufen werden sollen. Der Index reicht von null bis eins kleiner als die Anzahl der Filtertags, die von einem ACM-Treiber unterstützt werden. Die Anzahl der von einem Treiber unterstützten Filtertags ist in der ACMDRIVERDETAILS-Struktur enthalten. Der dwFilterTagIndex-Member wird nur beim Abfragen von Filtertagdetails zu einem Treiber nach Index verwendet. Andernfalls sollte dieser Member 0 (null) sein.

dwFilterTag

Waveform-audio-Filtertag, das in der Struktur ACMFILTERTAGDETAILS beschrieben wird. Dieser Member wird als Eingabe für die ACM_FILTERTAGDETAILSF_FILTERTAG- und ACM_FILTERTAGDETAILSF_LARGESTSIZE-Abfrageflags verwendet. Dieser Member wird immer zurückgegeben, wenn die Funktion acmFilterTagDetails erfolgreich ist. Dieser Member sollte für alle anderen Abfrageflags auf WAVE_FILTER_UNKNOWN festgelegt werden.

cbFilterSize

Die größte Gesamtgröße eines Waveform-Audiofilters vom Typ dwFilterTag in Byte. Beispielsweise ist dieses Element für WAVE_FILTER_ECHO 40 und für WAVE_FILTER_VOLUME 36.

fdwSupport

Treiberunterstützungsflags, die für das Filtertag spezifisch sind. Diese Flags sind mit der ACMDRIVERDETAILS-Struktur identisch. Dieser Member kann eine Kombination der folgenden Werte sein und identifiziert, welche Vorgänge der Treiber mit dem Filtertag unterstützt:

Name BESCHREIBUNG
ACMDRIVERDETAILS_SUPPORTF_ASYNC
 Der Treiber unterstützt asynchrone Konvertierungen.
ACMDRIVERDETAILS_SUPPORTF_CODEC
 Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formattags, während das angegebene Filtertag verwendet wird. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM mit dem angegebenen Filtertag unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER
 Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten desselben Formattags, während das angegebene Filtertag verwendet wird. Wenn ein Treiber z. B. die Neusampling von WAVE_FORMAT_PCM mit dem angegebenen Filtertag unterstützt, wird dieses Flag festgelegt.
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 mit dem angegebenen Filtertag über ein Waveform-Audiogerä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.

cStandardFilters

Anzahl der Standardfilter des dwFilterTag-Typs (d. a. die Kombination aller Filtermerkmale). Dieser Wert kann nicht alle filter angeben, die vom Treiber unterstützt werden.

szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS]

Zeichenfolge, die den DwFilterTag-Typ beschreibt. Diese Zeichenfolge wird immer zurückgegeben, wenn die Funktion acmFilterTagDetails erfolgreich ist.

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

ACMDRIVERDETAILS

Audiokomprimierungs-Manager

Audiokomprimierungsstrukturen

acmFilterTagDetails

acmFilterTagEnum