funzione acmMetrics (msacm.h)

Articolo
08/24/2023

La funzione acmMetrics restituisce varie metriche per gli oggetti ACM o ACM correlati.

Sintassi

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

Parametri

hao

Gestire l'oggetto ACM per eseguire query sulla metrica specificata in uMetric. Per alcune query, questo parametro può essere NULL.

uMetric

Indice metrico da restituire in pMetric.

Valore	Significato
ACM_METRIC_COUNT_CODECS	Il valore restituito è il numero di driver di compressore O decompressor globali nel sistema. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_COUNT_CONVERTERS	Il valore restituito è il numero di driver del convertitore ACM globali nel sistema. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_COUNT_DISABLED	Il valore restituito è il numero totale di driver ACM disabilitati globali (di tutti i tipi di supporto) nel sistema. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD . La somma degli indici di ACM_METRIC_COUNT_DRIVERS e ACM_METRIC_COUNT_DISABLED delle metriche è il numero totale di driver ACM installati a livello globale.
ACM_METRIC_COUNT_DRIVERS	Il valore restituito è il numero totale di driver ACM globali abilitati (di tutti i tipi di supporto) nel sistema. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_COUNT_FILTERS	Il valore restituito è il numero di driver di filtro ACM globali nel sistema. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_COUNT_HARDWARE	Il valore restituito è il numero di driver hardware ACM globali nel sistema. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_COUNT_LOCAL_CODECS	Il valore restituito è il numero di driver del compressore ACM locale, driver decompressor ACM o entrambi per l'attività chiamante. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_COUNT_LOCAL_CONVERTERS	Il valore restituito è il numero di driver del convertitore ACM locale per l'attività chiamante. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_COUNT_LOCAL_DISABLED	Il valore restituito è il numero totale di driver ACM locali disabilitati, di tutti i tipi di supporto, per l'attività chiamante. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD . La somma degli indici delle metriche ACM_METRIC_COUNT_LOCAL_DRIVERS e ACM_METRIC_COUNT_LOCAL_DISABLED è il numero totale di driver ACM installati in locale.
ACM_METRIC_COUNT_LOCAL_DRIVERS	Il valore restituito è il numero totale di driver ACM locali abilitati (di tutti i tipi di supporto) per l'attività chiamante. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_COUNT_LOCAL_FILTERS	Il valore restituito è il numero di driver di filtro ACM locali per l'attività chiamante. Il parametro hao deve essere NULL per questo indice di metrica. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_DRIVER_PRIORITY	Il valore restituito è la priorità corrente per il driver specificato. Il parametro hao deve essere un identificatore di driver ACM valido del tipo di dati HACMDRIVERID . Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_DRIVER_SUPPORT	Il valore restituito è il flag fdwSupport per il driver specificato. Il parametro hao deve essere un identificatore di driver ACM valido del tipo di dati HACMDRIVERID . Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_HARDWARE_WAVE_INPUT	Il valore restituito è l'identificatore del dispositivo di input waveform-audio associato al driver specificato. Il parametro hao deve essere un identificatore di driver ACM valido del tipo di dati HACMDRIVERID che supporta il flag di ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Se non viene associato alcun dispositivo di input waveform-audio al driver, viene restituito MMSYSERR_NOTSUPPORTED. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_HARDWARE_WAVE_OUTPUT	Il valore restituito è l'identificatore del dispositivo di output waveform-audio associato al driver specificato. Il parametro hao deve essere un identificatore di driver ACM valido del tipo di dati HACMDRIVERID che supporta il flag di ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Se non viene associato alcun dispositivo di output waveform-audio al driver, MMSYSERR_NOTSUPPORTED viene restituito. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD .
ACM_METRIC_MAX_SIZE_FILTER	Il valore restituito è la dimensione della struttura WAVEFILTER più grande. Se hao è NULL, il valore restituito è la struttura WAVEFILTER più grande nel sistema. Se hao identifica un'istanza aperta di un driver ACM del tipo di dati HACMDRIVER o un identificatore del driver ACM del tipo di dati HACMDRIVERID , viene restituita la struttura WAVEFILTER più grande per tale driver. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD . Questa metrica non è consentita per un handle di flusso ACM del tipo di dati HACMSTREAM .
ACM_METRIC_MAX_SIZE_FORMAT	Il valore restituito è la dimensione della struttura WAVEFORMATEX più grande. Se hao è NULL, il valore restituito è la struttura WAVEFORMATEX più grande nel sistema. Se hao identifica un'istanza aperta di un driver ACM del tipo di dati HACMDRIVER o un identificatore del driver ACM del tipo di dati HACMDRIVERID , viene restituita la struttura WAVEFORMATEX più grande per tale driver. Il parametro pMetric deve puntare a un buffer di dimensioni uguali a un valore DWORD . Questa metrica non è consentita per un handle di flusso ACM del tipo di dati HACMSTREAM .

pMetric

Puntatore al buffer per ricevere i dettagli della metrica. La definizione esatta dipende dall'indice uMetric .

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
ACMERR_NOTPOSSIBLE	Impossibile restituire l'indice specificato in uMetric per l'hao specificato.
MMSYSERR_INVALHANDLE	L'handle specificato non è valido.
MMSYSERR_INVALPARAM	Almeno un parametro non è valido.
MMSYSERR_NOTSUPPORTED	L'indice specificato in uMetric non è supportato.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msacm.h
Libreria	Msacm32.lib
DLL	Msacm32.dll

Vedi anche

Funzioni di compressione audio

Gestione compressione audio

Share via