Struttura ACMFILTERDETAILS (msacm.h)

Articolo
08/24/2023

La struttura ACMFILTERDETAILS descrive in dettaglio un filtro audio waveform per un tag di filtro specifico per un driver ACM.

Sintassi

typedef struct tACMFILTERDETAILS {
  DWORD        cbStruct;
  DWORD        dwFilterIndex;
  DWORD        dwFilterTag;
  DWORD        fdwSupport;
  LPWAVEFILTER pwfltr;
  DWORD        cbwfltr;
  char         szFilter[ACMFILTERDETAILS_FILTER_CHARS];
} ACMFILTERDETAILS, *PACMFILTERDETAILS, *LPACMFILTERDETAILS;

Members

cbStruct

Dimensioni, in byte, della struttura ACMFILTERDETAILS . Questo membro deve essere inizializzato prima di chiamare le funzioni acmFilterDetails o acmFilterEnum . Le dimensioni specificate in questo membro devono essere sufficienti per contenere la struttura ACMFILTERDETAILS di base. Quando viene restituita la funzione acmFilterDetails , questo membro contiene le dimensioni effettive delle informazioni restituite. Le informazioni restituite non supereranno mai le dimensioni richieste.

dwFilterIndex

Indice del filtro sui dettagli che verranno recuperati. L'indice varia da zero a uno minore del numero di filtri standard supportati da un driver ACM per un tag di filtro. Il numero di filtri standard supportati da un driver per un tag di filtro è contenuto nella struttura ACMFILTERTAGDETAILS . Il membro dwFilterIndex viene usato solo quando si eseguono query sui dettagli del filtro standard su un driver per indice; in caso contrario, questo membro deve essere zero. Inoltre, questo membro verrà impostato su zero da ACM quando un'applicazione esegue una query per informazioni dettagliate su un filtro; in altre parole, questo membro viene usato solo per l'input e non viene mai restituito da ACM o da un driver ACM.

dwFilterTag

Tag di filtro audio waveform descritto dalla struttura ACMFILTERDETAILS . Questo membro viene usato come input per il flag di query ACM_FILTERDETAILSF_INDEX. Per il flag di query ACM_FILTERDETAILSF_FORMAT, questo membro deve essere inizializzato nello stesso tag di filtro specificato dal membro pwfltr . Se la funzione acmFilterDetails ha esito positivo, questo membro viene sempre restituito. Questo membro deve essere impostato su WAVE_FILTER_UNKNOWN per tutti gli altri flag di query.

fdwSupport

Flag di supporto driver specifici del filtro specificato. Questi flag sono identici alla struttura ACMDRIVERDETAILS , ma sono specifici del filtro su cui viene eseguita la query. Questo membro può essere una combinazione dei valori seguenti e identifica le operazioni supportate dal driver per il tag di filtro:

Nome	Descrizione
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Il driver supporta le conversioni asincrone.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Il driver supporta la conversione tra due tag di formato diversi durante l'uso del filtro specificato. Ad esempio, se un driver supporta la compressione da WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con il filtro specificato, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Il driver supporta la conversione tra due formati diversi dello stesso tag di formato durante l'uso del filtro specificato. Ad esempio, se un driver supporta il ricampionamento di WAVE_FORMAT_PCM con il filtro specificato, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Il driver supporta un filtro (modifica dei dati senza modificare alcun attributo di formato). Ad esempio, se un driver supporta operazioni di volume o echo su WAVE_FORMAT_PCM, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Il driver supporta l'input hardware, l'output o entrambi con il filtro specificato tramite un dispositivo audio waveform. Un'applicazione deve usare la funzione acmMetrics con gli indici delle metriche ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT per recuperare gli identificatori di dispositivo audio waveform associati al driver ACM di supporto.

pwfltr

Puntatore a una struttura WAVEFILTER che riceverà i dettagli del filtro. Questa struttura non richiede l'inizializzazione da parte dell'applicazione, a meno che non venga specificato il flag ACM_FILTERDETAILSF_FILTER con la funzione acmFilterDetails . In questo caso, il membro dwFilterTag della struttura WAVEFILTER deve essere uguale al membro dwFilterTag della struttura ACMFILTERDETAILS .

cbwfltr

Dimensioni, in byte, disponibili per pwfltr per ricevere i dettagli del filtro. Le funzioni acmMetrics e acmFilterTagDetails possono essere usate per determinare le dimensioni massime necessarie per qualsiasi filtro disponibile per il driver specificato (o per tutti i driver ACM installati).

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

Stringa che descrive il filtro per il tipo dwFilterTag . Se la funzione acmFilterDetails ha esito positivo, questa stringa viene sempre restituita.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	msacm.h