funzione acmFormatTagEnumA (msacm.h)
La funzione acmFormatTagEnum enumera i tag di formato waveform-audio 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 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
Riservati; deve essere zero.
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 |
|---|---|
|
Almeno un flag non è valido. |
|
L'handle specificato non è valido. |
|
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.
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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |