funzione acmFormatDetailsA (msacm.h)
La funzione acmFormatDetails esegue una query ACM per ottenere i dettagli di 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 sui 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 la struttura (./nf-msacm-acmformatdetails.md) e devono essere restituiti i dettagli rimanenti. Il membro dwFormatTag della struttura ACMFORMATDETAILS 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 had, i dettagli sul formato verranno restituiti per tale driver. Se un'applicazione specifica NULL per had, ACM trova il primo driver accettabile per restituire i dettagli.| Valore | Significato |
|---|---|
| ACM_FORMATDETAILSF_FORMAT | |
| ACM_FORMATDETAILSF_INDEX | È stato assegnato un indice di formato per il tag di formato 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 ACMFORMATTAGDETAILS per un tag di formato. Un'applicazione deve specificare un handle driver per had 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 valori di errore possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
I dettagli richiesti non sono disponibili. |
|
Almeno un flag non è valido. |
|
L'handle specificato non è valido. |
|
Almeno un parametro non è valido. |
Commenti
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 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
| 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 |