Funzione acmFormatTagEnumA (msacm.h)

Articolo
11/20/2024

La funzione acmFormatTagEnum enumera i tag di formato audio waveform disponibili da un driver ACM. Questa funzione continua l'enumerazione finché non sono presenti tag di formato più adatti o la funzione di callback restituisce FALSE.

Sintassi

MMRESULT ACMAPI acmFormatTagEnumA(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSA paftd,
  ACMFORMATTAGENUMCBA    fnCallback,
  DWORD_PTR              dwInstance,
  DWORD                  fdwEnum
);

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.

paftd

Puntatore alla struttura ACMFORMATTAGDETAILS che deve ricevere i dettagli del tag di formato passati alla funzione specificata in fnCallback. Questa struttura deve avere il membro cbStruct della struttura ACMFORMATTAGDETAILS inizializzata.

fnCallback

Indirizzo dell'istanza di routine della funzione di callback definita dall'applicazione.

dwInstance

Valore definito dall'applicazione a 64 bit (DWORD_PTR) o A 32 bit (DWORD) passato alla funzione di callback insieme ai dettagli del tag di formato ACM.

fdwEnum

Riservato; deve essere zero.

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
MMSYSERR_INVALFLAG	Almeno un flag non è valido.
MMSYSERR_INVALHANDLE	L'handle specificato non è valido.
MMSYSERR_INVALPARAM	Almeno un parametro non è valido.

Osservazioni

Questa funzione restituirà MMSYSERR_NOERROR (zero) se non sono installati driver ACM appropriati. Inoltre, la funzione di callback non verrà chiamata.

Nota

L'intestazione msacm.h definisce acmFormatTagEnum 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