Condividi tramite


funzione acmFormatDetails (msacm.h)

La funzione acmFormatDetails esegue una query sull'ACM per i dettagli del formato per un tag di formato waveform-audio specifico.

Sintassi

MMRESULT ACMAPI acmFormatDetails(
  HACMDRIVER         had,
  LPACMFORMATDETAILS pafd,
  DWORD              fdwDetails
);

Parametri

had

Gestire il driver ACM per eseguire una query sui dettagli del formato waveform-audio 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 waveform-audio. I valori seguenti sono definiti.

[ACMFORMATDETAILS] () struttura specificata e i dettagli rimanenti devono essere restituiti. 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 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 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 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 su quali membri devono essere inizializzati prima di chiamare questa funzione, vedere la struttura ACMFORMATDETAILS .

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

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