funzione acmFormatTagEnum (msacm.h)

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

Sintassi

MMRESULT ACMAPI acmFormatTagEnum(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  ACMFORMATTAGENUMCB    fnCallback,
  DWORD_PTR             dwInstance,
  DWORD                 fdwEnum
);

Parametri

had

Gestire il driver ACM per eseguire una query sui dettagli del tag di formato waveform-audio. 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

Riservati; deve essere zero.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario. I valori di errore possibili 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.

Commenti

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

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