Freigeben über


acmMetrics-Funktion (msacm.h)

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