ACMFORMATDETAILS-Struktur (msacm.h)

Artikel
03/06/2024

Die ACMFORMATDETAILS-Struktur enthält details eines Waveform-Audioformats für ein bestimmtes Formattag für einen ACM-Treiber.

Syntax

typedef struct tACMFORMATDETAILS {
  DWORD          cbStruct;
  DWORD          dwFormatIndex;
  DWORD          dwFormatTag;
  DWORD          fdwSupport;
  LPWAVEFORMATEX pwfx;
  DWORD          cbwfx;
  char           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
} ACMFORMATDETAILS, *PACMFORMATDETAILS, *LPACMFORMATDETAILS;

Member

cbStruct

Größe der ACMFORMATDETAILS-Struktur in Bytes. Dieses Member muss initialisiert werden, bevor eine Anwendung die Funktion acmFormatDetails oder acmFormatEnum aufruft. Die von diesem Member angegebene Größe muss groß genug sein, um die ACMFORMATDETAILS-Basisstruktur zu enthalten. Wenn die acmFormatDetails-Funktion zurückgibt, enthält dieses Element die tatsächliche Größe der zurückgegebenen Informationen. Die zurückgegebenen Informationen überschreiten nie die angeforderte Größe.

dwFormatIndex

Index des Formats, für das Details abgerufen werden sollen. Der Index reicht von null bis 1 weniger als die Anzahl der Standardformate, die von einem ACM-Treiber für ein Formattag unterstützt werden. Die Anzahl der Standardformate, die von einem Treiber für ein Formattag unterstützt werden, ist in der Struktur ACMFORMATTAGDETAILS enthalten. Der dwFormatIndex-Member wird nur verwendet, wenn eine Anwendung Standardformatdetails zu einem Treiber nach Index abfragt. Andernfalls sollte dieser Member 0 sein. Außerdem wird dieser Member vom ACM auf 0 festgelegt, wenn eine Anwendung Details zu einem Format abfragt. Anders ausgedrückt: Dieser Member wird nur für die Eingabe verwendet und wird nie vom ACM oder einem ACM-Treiber zurückgegeben.

dwFormatTag

Waveform-Audioformat-Tag, das die Struktur ACMFORMATDETAILS beschreibt. Dieses Element wird für die Eingabe für das ACM_FORMATDETAILSF_INDEX-Abfrageflag verwendet. Für das ACM_FORMATDETAILSF_FORMAT Abfrageflags muss dieses Element mit dem gleichen Formattag initialisiert werden, das das pwfx-Element angibt. Wenn ein Aufruf der acmFormatDetails-Funktion erfolgreich ist, wird dieser Member immer zurückgegeben. Dieser Member sollte für alle anderen Abfrageflags auf WAVE_FORMAT_UNKNOWN festgelegt werden.

fdwSupport

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

Name	BESCHREIBUNG
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Der Treiber unterstützt asynchrone Konvertierungen mit dem angegebenen Formattag.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formattags für das angegebene Format. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM mit dem angegebenen Format 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 Format verwendet wird. Wenn ein Treiber beispielsweise die Neustempelung von WAVE_FORMAT_PCM in das angegebene Format unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Der Treiber unterstützt einen Filter (der Daten ändert, ohne Formatattribute zu ändern) mit dem angegebenen Format. 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 die Hardwareeingabe und/oder -ausgabe des angegebenen Formats über ein Waveform-Audiogerät. Eine Anwendung sollte acmMetrics 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.

pwfx

Zeiger auf eine WAVEFORMATEX-Struktur , die die Formatdetails empfängt. Diese Struktur erfordert keine Initialisierung durch die Anwendung, es sei denn, das ACM_FORMATDETAILSF_FORMAT-Flag wird in der Funktion acmFormatDetails angegeben. In diesem Fall muss das wFormatTag-Element der WAVEFORMATEX-Struktur gleich dem dwFormatTag der ACMFORMATDETAILS-Struktur sein.

cbwfx

Größe in Bytes, die für pwfx verfügbar ist, um die Formatdetails zu erhalten. Die Funktionen acmMetrics und acmFormatTagDetails können verwendet werden, um die maximale Größe zu bestimmen, die für jedes Format erforderlich ist, das für den angegebenen Treiber (oder für alle installierten ACM-Treiber) verfügbar ist.

szFormat[ACMFORMATDETAILS_FORMAT_CHARS]

Zeichenfolge, die das Format für den dwFormatTag-Typ beschreibt. Wenn die acmFormatDetails-Funktion erfolgreich ist, wird diese Zeichenfolge immer zurückgegeben.

Anforderungen

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