funzione acmFormatTagDetails (msacm.h)

Articolo
03/15/2023

La funzione acmFormatTagDetails esegue una query ACM per informazioni dettagliate su un tag di formato audio waveform specifico.

Sintassi

MMRESULT ACMAPI acmFormatTagDetails(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  DWORD                 fdwDetails
);

Parametri

had

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

paftd

Puntatore alla struttura ACMFORMATTAGDETAILS che deve ricevere i dettagli del tag di formato.

fdwDetails

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

[ACMFORMATTAGDETAILS] () struttura. I dettagli del tag di formato verranno restituiti nella struttura a cui punta paftd. Se un'applicazione specifica un handle di driver ACM per had, i dettagli sul tag di formato 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 formato con questo flag. [ACMFORMATTAGDETAILS] () la struttura deve essere WAVE_FORMAT_UNKNOWN o il tag di formato per trovare le dimensioni maggiori. Se un'applicazione specifica un handle di driver ACM per had, verranno restituiti dettagli sul tag di formato più grande per tale driver. Se un'applicazione specifica NULL per had, ACM trova un driver accettabile con il tag di formato più grande richiesto per restituire i dettagli.

Valore	Significato
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

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

Share via