funzione acmFilterDetails (msacm.h)

Articolo
08/24/2023

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

Sintassi

MMRESULT ACMAPI acmFilterDetails(
  HACMDRIVER         had,
  LPACMFILTERDETAILS pafd,
  DWORD              fdwDetails
);

Parametri

had

Gestire il driver ACM per eseguire una query sui dettagli del filtro audio waveform per un tag di filtro. Se questo parametro è NULL, ACM usa i dettagli del primo driver ACM appropriato.

pafd

Puntatore alla struttura ACMFILTERDETAILS che deve ricevere i dettagli del filtro per il tag di filtro specificato.

fdwDetails

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

[ACMFILTERDETAILS] () è stata assegnata la struttura e devono essere restituiti i dettagli rimanenti. Il membro dwFilterTag della struttura ACMFILTERDETAILS deve essere inizializzato nello stesso tag di filtro pwfltr specificato. Questo tipo di query può essere usato per ottenere una descrizione stringa di una struttura di filtro arbitraria. Se un'applicazione specifica un handle di driver ACM per had, i dettagli sul filtro verranno restituiti per tale driver. Se un'applicazione specifica NULL per had, ACM trova il primo driver accettabile per restituire i dettagli.

Valore	Significato
ACM_FILTERDETAILSF_FILTER
ACM_FILTERDETAILSF_INDEX	È stato assegnato un indice di filtro per il tag di filtro nel membro dwFilterIndex della struttura ACMFILTERDETAILS . I dettagli del filtro verranno restituiti nella struttura definita da pafd. L'indice varia da zero a uno minore del membro cStandardFilters restituito nella struttura ACMFILTERTAGDETAILS per un tag di filtro. Un'applicazione deve specificare un handle driver per had durante il recupero dei dettagli del filtro con questo flag. Per informazioni sui membri da inizializzare prima di chiamare questa funzione, vedere la struttura ACMFILTERDETAILS .

Valore

Significato

ACM_FILTERDETAILSF_FILTER

ACM_FILTERDETAILSF_INDEX

È stato assegnato un indice di filtro per il tag di filtro nel membro dwFilterIndex della struttura ACMFILTERDETAILS . I dettagli del filtro verranno restituiti nella struttura definita da pafd. L'indice varia da zero a uno minore del membro cStandardFilters restituito nella struttura ACMFILTERTAGDETAILS per un tag di filtro. Un'applicazione deve specificare un handle driver per had durante il recupero dei dettagli del filtro con questo flag. Per informazioni sui membri da inizializzare prima di chiamare questa funzione, vedere la struttura ACMFILTERDETAILS .

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


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

Condividi tramite