ACMFILTERDETAILS-Struktur (msacm.h)

Artikel
08/24/2023

Die Struktur ACMFILTERDETAILS enthält Details zu einem Waveform-Audiofilter für ein bestimmtes Filtertag für einen ACM-Treiber.

Syntax

typedef struct tACMFILTERDETAILS {
  DWORD        cbStruct;
  DWORD        dwFilterIndex;
  DWORD        dwFilterTag;
  DWORD        fdwSupport;
  LPWAVEFILTER pwfltr;
  DWORD        cbwfltr;
  char         szFilter[ACMFILTERDETAILS_FILTER_CHARS];
} ACMFILTERDETAILS, *PACMFILTERDETAILS, *LPACMFILTERDETAILS;

Members

cbStruct

Größe der ACMFILTERDETAILS-Struktur in Bytes. Dieses Element muss initialisiert werden, bevor die Funktionen acmFilterDetails oder acmFilterEnum aufgerufen werden. Die in diesem Member angegebene Größe muss groß genug sein, um die ACMFILTERDETAILS-Basisstruktur zu enthalten. Wenn die acmFilterDetails-Funktion zurückgegeben wird, enthält dieses Element die tatsächliche Größe der zurückgegebenen Informationen. Die zurückgegebenen Informationen überschreiten nie die angeforderte Größe.

dwFilterIndex

Index des Filters darüber, welche Details abgerufen werden. Der Index reicht von null bis eins kleiner als die Anzahl der Standardfilter, die von einem ACM-Treiber für ein Filtertag unterstützt werden. Die Anzahl der Standardfilter, die von einem Treiber für ein Filtertag unterstützt werden, ist in der Struktur ACMFILTERTAGDETAILS enthalten. Der dwFilterIndex-Member wird nur beim Abfragen von Standardfilterdetails zu einem Treiber nach Index verwendet. Andernfalls sollte dieser Member 0 sein. Außerdem wird dieser Member vom ACM auf 0 festgelegt, wenn eine Anwendung Details zu einem Filter abfragt. Anders ausgedrückt: Dieser Member wird nur für die Eingabe verwendet und wird nie vom ACM oder einem ACM-Treiber zurückgegeben.

dwFilterTag

Waveform-Audio-Filtertag, das die Struktur ACMFILTERDETAILS beschreibt. Dieses Element wird als Eingabe für das ACM_FILTERDETAILSF_INDEX-Abfrageflag verwendet. Für das ACM_FILTERDETAILSF_FORMAT-Abfrageflags muss dieses Element mit demselben Filtertag initialisiert werden, das das pwfltr-Element angibt. Wenn die acmFilterDetails-Funktion erfolgreich ist, wird dieser Member immer zurückgegeben. Dieses Element sollte für alle anderen Abfrageflags auf WAVE_FILTER_UNKNOWN festgelegt werden.

fdwSupport

Treiberunterstützungsflags, die für den angegebenen Filter spezifisch sind. Diese Flags sind mit der ACMDRIVERDETAILS-Struktur identisch, aber sie sind spezifisch für den filter, der abgefragt wird. Dieser Member kann eine Kombination aus den folgenden Werten sein und gibt an, welche Vorgänge der Treiber für das 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 der angegebene Filter verwendet wird. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM mit dem angegebenen Filter unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten desselben Formattags bei Verwendung des angegebenen Filters. Wenn ein Treiber beispielsweise die Neustempelung von WAVE_FORMAT_PCM mit dem angegebenen Filter unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Der Treiber unterstützt einen Filter (Änderung der Daten ohne Ändern der Formatattribute). Wenn ein Treiber beispielsweise Volume- oder Echovorgänge auf WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Der Treiber unterstützt Hardwareeingabe, -ausgabe oder beides mit dem angegebenen Filter ü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 Waveform-Audiogerätebezeichner abzurufen, die dem unterstützenden ACM-Treiber zugeordnet sind.

pwfltr

Zeiger auf eine WAVEFILTER-Struktur , die die Filterdetails empfängt. Diese Struktur erfordert keine Initialisierung durch die Anwendung, es sei denn, das ACM_FILTERDETAILSF_FILTER Flag wird mit der Funktion acmFilterDetails angegeben. In diesem Fall muss das dwFilterTag-Element der WAVEFILTER-Struktur gleich dem dwFilterTag-Member der ACMFILTERDETAILS-Struktur sein.

cbwfltr

Größe in Bytes, die für pwfltr verfügbar ist, um die Filterdetails zu erhalten. Die Funktionen acmMetrics und acmFilterTagDetails können verwendet werden, um die maximale Größe zu bestimmen, die für jeden Filter erforderlich ist, der für den angegebenen Treiber (oder für alle installierten ACM-Treiber) verfügbar ist.

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

Zeichenfolge, die den Filter für den dwFilterTag-Typ beschreibt. Wenn die Funktion acmFilterDetails erfolgreich ist, wird diese Zeichenfolge immer zurückgegeben.

Anforderungen


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