funzione acmFilterTagDetails (msacm.h)

La funzione acmFilterTagDetails esegue una query ACM per informazioni dettagliate su un tag di filtro waveform-audio specifico.

Sintassi

MMRESULT ACMAPI acmFilterTagDetails(
  HACMDRIVER            had,
  LPACMFILTERTAGDETAILS paftd,
  DWORD                 fdwDetails
);

Parametri

had

Gestire il driver ACM per eseguire una query per ottenere i dettagli del tag di filtro audio waveform. Se questo parametro è NULL, ACM usa i dettagli del primo driver ACM appropriato. Un'applicazione deve specificare un identificatore HACMDRIVER o HACMDRIVERID valido quando si usa il tipo di query ACM_FILTERTAGDETAILSF_INDEX. Gli identificatori del driver per i driver disabilitati non sono consentiti.

paftd

Puntatore alla struttura ACMFILTERTAGDETAILS che deve ricevere i dettagli del tag di filtro.

fdwDetails

Flag per ottenere i dettagli. Vengono definiti i valori seguenti.

[ACMFILTERTAGDETAILS] () struttura. I dettagli del tag di filtro verranno restituiti nella struttura a cui punta paftd. Se un'applicazione specifica un handle di driver ACM per had, i dettagli sul tag di filtro verranno restituiti per tale driver. Se un'applicazione specifica NULL per had, ACM trova il primo driver accettabile per restituire i dettagli. [ACMDRIVERDETAILS] Struttura (./nf-msacm-acmdriverdetails.md) per un driver ACM. Un'applicazione deve specificare un handle driver per had durante il recupero dei dettagli del tag di filtro con questo flag.

Valore	Significato
ACM_FILTERTAGDETAILSF_FILTERTAG
ACM_FILTERTAGDETAILSF_INDEX
ACM_FILTERTAGDETAILSF_LARGESTSIZE	I dettagli sul tag di filtro con la dimensione massima del filtro, espressa in byte, devono essere restituiti. Il membro dwFilterTag deve essere WAVE_FILTER_UNKNOWN o il tag di filtro per trovare le dimensioni maggiori. Se un'applicazione specifica un handle di driver ACM per had, verranno restituiti i dettagli sul tag di filtro più grande per tale driver. Se un'applicazione specifica NULL per had, ACM trova un driver accettabile con il tag di filtro più grande richiesto per restituire i dettagli.

Valore restituito

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

Codice restituito	Descrizione
ACMERR_NOTPOSSIBLE	I dettagli richiesti non sono disponibili.
MMSYSERR_INVALFLAG	Almeno un flag non è valido.
MMSYSERR_INVALHANDLE	L'handle specificato non è valido.
MMSYSERR_INVALPARAM	Almeno un parametro non è valido.

Requisiti

Requisito	Valore
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