acmMetrics-Funktion (msacm.h)

Artikel
08/24/2023

Die acmMetrics-Funktion gibt verschiedene Metriken für die ACM-Objekte oder verwandte ACM-Objekte zurück.

Syntax

MMRESULT ACMAPI acmMetrics(
  HACMOBJ hao,
  UINT    uMetric,
  LPVOID  pMetric
);

Parameter

hao

Verarbeiten Sie das ACM-Objekt, um die in uMetric angegebene Metrik abzufragen. Bei einigen Abfragen kann dieser Parameter NULL sein.

uMetric

Metrikindex, der in pMetric zurückgegeben werden soll.

Wert	Bedeutung
ACM_METRIC_COUNT_CODECS	Der zurückgegebene Wert ist die Anzahl der globalen ACM-Kompressor- oder Dekomprimierungstreiber im System. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_COUNT_CONVERTERS	Der zurückgegebene Wert ist die Anzahl der globalen ACM-Konvertertreiber im System. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_COUNT_DISABLED	Der zurückgegebene Wert ist die Gesamtzahl der global deaktivierten ACM-Treiber (aller Supporttypen) im System. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht. Die Summe der ACM_METRIC_COUNT_DRIVERS- und ACM_METRIC_COUNT_DISABLED Metrikindizes entspricht der Gesamtzahl der global installierten ACM-Treiber.
ACM_METRIC_COUNT_DRIVERS	Der zurückgegebene Wert ist die Gesamtzahl der aktivierten globalen ACM-Treiber (aller Supporttypen) im System. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_COUNT_FILTERS	Der zurückgegebene Wert ist die Anzahl der globalen ACM-Filtertreiber im System. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_COUNT_HARDWARE	Der zurückgegebene Wert ist die Anzahl der globalen ACM-Hardwaretreiber im System. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_COUNT_LOCAL_CODECS	Der zurückgegebene Wert ist die Anzahl der lokalen ACM-Kompressortreiber, ACM-Dekomprimierungstreiber oder beides für die aufrufende Aufgabe. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_COUNT_LOCAL_CONVERTERS	Der zurückgegebene Wert ist die Anzahl der lokalen ACM-Konvertertreiber für den aufrufenden Task. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_COUNT_LOCAL_DISABLED	Der zurückgegebene Wert ist die Gesamtzahl der lokal deaktivierten ACM-Treiber aller Supporttypen für den aufrufenden Task. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht. Die Summe der ACM_METRIC_COUNT_LOCAL_DRIVERS- und ACM_METRIC_COUNT_LOCAL_DISABLED Metrikindizes ist die Gesamtzahl der lokal installierten ACM-Treiber.
ACM_METRIC_COUNT_LOCAL_DRIVERS	Der zurückgegebene Wert ist die Gesamtzahl der aktivierten lokalen ACM-Treiber (aller Supporttypen) für den aufrufenden Task. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_COUNT_LOCAL_FILTERS	Der zurückgegebene Wert ist die Anzahl der lokalen ACM-Filtertreiber für den aufrufenden Task. Der hao-Parameter muss null für diesen Metrikindex sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_DRIVER_PRIORITY	Der zurückgegebene Wert ist die aktuelle Priorität für den angegebenen Treiber. Der hao-Parameter muss ein gültiger ACM-Treiberbezeichner des HACMDRIVERID-Datentyps sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_DRIVER_SUPPORT	Der zurückgegebene Wert ist die fdwSupport-Flags für den angegebenen Treiber. Der hao-Parameter muss ein gültiger ACM-Treiberbezeichner des HACMDRIVERID-Datentyps sein. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_HARDWARE_WAVE_INPUT	Der zurückgegebene Wert ist die Dem angegebenen Treiber zugeordnete Signalform-Audioeingabegeräte-ID. Der hao-Parameter muss ein gültiger ACM-Treiberbezeichner des HACMDRIVERID-Datentyps sein, der das ACMDRIVERDETAILS_SUPPORTF_HARDWARE-Flag unterstützt. Wenn dem Treiber kein Waveform-Audio-Eingabegerät zugeordnet ist, wird MMSYSERR_NOTSUPPORTED zurückgegeben. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_HARDWARE_WAVE_OUTPUT	Der zurückgegebene Wert ist der Gerätebezeichner für waveform-audio, der dem angegebenen Treiber zugeordnet ist. Der hao-Parameter muss ein gültiger ACM-Treiberbezeichner des HACMDRIVERID-Datentyps sein, der das ACMDRIVERDETAILS_SUPPORTF_HARDWARE-Flag unterstützt. Wenn dem Treiber kein Waveform-Audioausgabegerät zugeordnet ist, wird MMSYSERR_NOTSUPPORTED zurückgegeben. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht.
ACM_METRIC_MAX_SIZE_FILTER	Der zurückgegebene Wert ist die Größe der größten WAVEFILTER-Struktur . Wenn haoNULL ist, ist der Rückgabewert die größte WAVEFILTER-Struktur im System. Wenn hao einen offenen instance eines ACM-Treibers des HACMDRIVER-Datentyps oder einen ACM-Treiberbezeichner des HACMDRIVERID-Datentyps identifiziert, wird die größte WAVEFILTER-Struktur für diesen Treiber zurückgegeben. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht. Diese Metrik ist für ein ACM-Streamhandle des HACMSTREAM-Datentyps nicht zulässig.
ACM_METRIC_MAX_SIZE_FORMAT	Der zurückgegebene Wert ist die Größe der größten WAVEFORMATEX-Struktur . Wenn haoNULL ist, ist der Rückgabewert die größte WAVEFORMATEX-Struktur im System. Wenn hao einen offenen instance eines ACM-Treibers des HACMDRIVER-Datentyps oder einen ACM-Treiberbezeichner des HACMDRIVERID-Datentyps identifiziert, wird die größte WAVEFORMATEX-Struktur für diesen Treiber zurückgegeben. Der pMetric-Parameter muss auf einen Puffer mit einer Größe zeigen, die einem DWORD-Wert entspricht. Diese Metrik ist für ein ACM-Streamhandle des HACMSTREAM-Datentyps nicht zulässig.

pMetric

Zeiger auf den Puffer, um die Metrikdetails zu empfangen. Die genaue Definition hängt vom uMetric-Index ab.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
ACMERR_NOTPOSSIBLE	Der in uMetric angegebene Index kann für den angegebenen hao nicht zurückgegeben werden.
MMSYSERR_INVALHANDLE	Das angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM	Mindestens ein Parameter ist ungültig.
MMSYSERR_NOTSUPPORTED	Der in uMetric angegebene Index wird nicht unterstützt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msacm.h
Bibliothek	Msacm32.lib
DLL	Msacm32.dll

Weitere Informationen

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager