Funzione acmFormatDetailsA (msacm.h)

Articolo
11/20/2024

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

Sintassi

MMRESULT ACMAPI acmFormatDetailsA(
  HACMDRIVER          had,
  LPACMFORMATDETAILSA pafd,
  DWORD               fdwDetails
);

Parametri

had

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

pafd

Puntatore a una struttura ACMFORMATDETAILS per contenere i dettagli del formato per il tag di formato specificato.

fdwDetails

Flag per ottenere i dettagli del tag di formato audio waveform. Vengono definiti i valori seguenti.

[ACMFORMATDETAILS]È stata assegnata una struttura (./nf-msacm-acmformatdetails.md) e devono essere restituiti i dettagli rimanenti. Il membro dwFormatTag della struttura ACMFORMATDETAILS di deve essere inizializzato nello stesso tag di formato specificato da pwfx. Questo tipo di query può essere usato per ottenere una descrizione stringa di una struttura di formato arbitrario. Se un'applicazione specifica un handle di driver ACM per aveva, verranno restituiti dettagli sul formato per tale driver. Se un'applicazione specifica NULL per aveva, ACM trova il primo driver accettabile per restituire i dettagli.

Valore	Significato
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX	Un indice di formato per il tag di formato è stato assegnato nel membro dwFormatIndex della struttura ACMFORMATDETAILS. I dettagli del formato verranno restituiti nella struttura definita da pafd. L'indice varia da zero a uno minore del membro cStandardFormats restituito nella struttura di ACMFORMATTAGDETAILS per un tag di formato. Un'applicazione deve specificare un handle driver per aveva durante il recupero dei dettagli del formato con questo flag. Per informazioni sui membri da inizializzare prima di chiamare questa funzione, vedere la struttura ACMFORMATDETAILS .

Valore

Significato

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

Un indice di formato per il tag di formato è stato assegnato nel membro dwFormatIndex della struttura ACMFORMATDETAILS. I dettagli del formato verranno restituiti nella struttura definita da pafd. L'indice varia da zero a uno minore del membro cStandardFormats restituito nella struttura di ACMFORMATTAGDETAILS per un tag di formato. Un'applicazione deve specificare un handle driver per aveva durante il recupero dei dettagli del formato con questo flag. Per informazioni sui membri da inizializzare prima di chiamare questa funzione, vedere la struttura ACMFORMATDETAILS .

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 ACMFORMATDETAILS 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