funzione acmMetrics (msacm.h)
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 |
|---|---|
|
Impossibile restituire l'indice specificato in uMetric per l'hao specificato. |
|
L'handle specificato non è valido. |
|
Almeno un parametro non è valido. |
|
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 |