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