ACMFORMATTAGDETAILS-Struktur (msacm.h)

  • Artikel

Die ACMFORMATTAGDETAILS-Struktur enthält details zu einem Waveform-Audio-Formattag für einen ACM-Treiber.

Syntax

typedef struct tACMFORMATTAGDETAILS {
  DWORD cbStruct;
  DWORD dwFormatTagIndex;
  DWORD dwFormatTag;
  DWORD cbFormatSize;
  DWORD fdwSupport;
  DWORD cStandardFormats;
  char  szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;

Members

cbStruct

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

dwFormatTagIndex

Index des Formattags, für das Details abgerufen werden. Der Index reicht von null bis 1 niedriger als die Anzahl der Formattags, die von einem ACM-Treiber unterstützt werden. Die Anzahl der von einem Treiber unterstützten Formattags ist in der ACMDRIVERDETAILS-Struktur enthalten. Der dwFormatTagIndex-Member wird nur beim Abfragen von Formattagdetails für einen Treiber nach Index verwendet. Andernfalls sollte dieser Member 0 (null) sein.

dwFormatTag

Waveform-Audio-Formattag, das von der ACMFORMATTAGDETAILS-Struktur beschrieben wird. Dieser Member wird für die Eingabe für die ACM_FORMATTAGDETAILSF_FORMATTAG und ACM_FORMATTAGDETAILSF_LARGESTSIZE Abfrageflags verwendet. Wenn die acmFormatTagDetails-Funktion erfolgreich ist, wird dieser Member immer zurückgegeben. Dieser Member sollte für alle anderen Abfrageflags auf WAVE_FORMAT_UNKNOWN festgelegt werden.

cbFormatSize

Größte Gesamtgröße in Bytes eines Waveform-Audioformats des Typs dwFormatTag . Beispielsweise ist dieser Member für WAVE_FORMAT_PCM 16 und für WAVE_FORMAT_ADPCM 50.

fdwSupport

Treiberunterstützungsflags, die für das Formattag spezifisch sind. Diese Flags sind mit der ACMDRIVERDETAILS-Struktur identisch. Dieser Member kann eine Kombination der folgenden Werte sein und auf die Vorgänge verweisen, die der Treiber mit dem 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, wobei eines der Tags das angegebene Formattag ist. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER
 Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten des angegebenen Formattags. Wenn z. B. ein Treiber das ErneutesAmpling von WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_FILTER
 Der Treiber unterstützt einen Filter (Änderung der Daten ohne Änderung der Formatattribute). Wenn beispielsweise ein Treiber Volume- oder Echovorgänge für das angegebene Formattag unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE
 Der Treiber unterstützt die Hardwareeingabe, -ausgabe oder beides des angegebenen Formattags ü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.

cStandardFormats

Anzahl der Standardformate des dwFormatTag-Typs ; d. h. die Kombination aller Abtastraten, Bits pro Stichprobe, Kanäle usw. Dieser Wert kann alle Formate angeben, die vom Treiber unterstützt werden, aber nicht unbedingt.

szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]

Zeichenfolge, die den dwFormatTag-Typ beschreibt. Wenn die acmFormatTagDetails-Funktion 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

Weitere Informationen

ACMDRIVERDETAILS

Audiokomprimierungs-Manager

Audiokomprimierungsstrukturen

acmFormatTagDetails

acmFormatTagEnum

acmMetrics