funzione acmFormatTagDetailsA (msacm.h)

Articolo
11/20/2024

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

Sintassi

MMRESULT ACMAPI acmFormatTagDetailsA(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSA paftd,
  DWORD                  fdwDetails
);

Parametri

had

Gestire il driver ACM per eseguire una query per ottenere 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 valido 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 (./nf-msacm-acmformattagdetails.md). I dettagli del tag di formato verranno restituiti nella struttura a cui punta paftd. Se un'applicazione specifica un handle di driver ACM per aveva, verranno restituiti i dettagli sul tag di formato per tale driver. Se un'applicazione specifica NULL per aveva, 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 aveva durante il recupero dei dettagli del tag di formato con questo flag. [ACMFORMATTAGDETAILS]La struttura (./nf-msacm-acmformattagdetails.md) 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 aveva, verranno restituiti i dettagli sul tag di formato più grande per tale driver. Se un'applicazione specifica NULL per aveva, Gestione configurazione di Azure rileva 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 possibili valori di errore 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.

Osservazioni

Nota

L'intestazione msacm.h definisce ACMFORMATTAGDETAILS come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	msacm.h
libreria	Msacm32.lib
dll	Msacm32.dll

Vedere anche

funzioni di compressione audio

gestione compressione audio

Condividi tramite