funzione acmFormatSuggest (msacm.h)

Articolo
08/24/2023

La funzione acmFormatSuggest esegue una query sul driver ACM o un driver ACM specificato per suggerire un formato di destinazione per il formato di origine fornito. Ad esempio, un'applicazione può usare questa funzione per determinare uno o più formati PCM validi a cui può essere decompresso un formato compresso.

Sintassi

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

Parametri

had

Gestire un'istanza aperta di un driver per eseguire una query per un formato di destinazione suggerito. Se questo parametro è NULL, ACM tenta di trovare il driver migliore per suggerire un formato di destinazione.

pwfxSrc

Puntatore a una struttura WAVEFORMATEX che identifica il formato di origine per cui verrà suggerito un formato di destinazione dal driver ACM o specificato.

pwfxDst

Puntatore a una struttura WAVEFORMATEX che riceverà il formato di destinazione suggerito per il formato pwfxSrc . A seconda del parametro fdwSuggest , alcuni membri della struttura puntati da pwfxDst possono richiedere l'inizializzazione.

cbwfxDst

Dimensioni, in byte, disponibili per il formato di destinazione. Le funzioni acmMetrics e acmFormatTagDetails possono essere usate per determinare le dimensioni massime necessarie per qualsiasi formato disponibile per il driver specificato (o per tutti i driver ACM installati).

fdwSuggest

Flag per la corrispondenza del formato di destinazione desiderato. I valori seguenti sono definiti.

Valore	Significato
ACM_FORMATSUGGESTF_NCHANNELS	Il membro nChannels della struttura a cui punta pwfxDst è valido. ACM eseguirà una query sui driver installati accettabili che possono suggerire un formato di destinazione corrispondente a nChannels o non riuscito.
ACM_FORMATSUGGESTF_NSAMPLESPERSEC	Il membro nSamplesPerSec della struttura a cui punta pwfxDst è valido. ACM eseguirà una query sui driver installati accettabili che possono suggerire un formato di destinazione corrispondente a nSamplesPerSec o non riuscito.
ACM_FORMATSUGGESTF_WBITSPERSAMPLE	Il membro wBitsPerSample della struttura a cui punta pwfxDst è valido. ACM eseguirà una query su driver installati accettabili che possono suggerire un formato di destinazione corrispondente a wBitsPerSample o non riuscito.
ACM_FORMATSUGGESTF_WFORMATTAG	Il membro wFormatTag della struttura a cui punta pwfxDst è valido. ACM eseguirà una query su driver installati accettabili che possono suggerire un formato di destinazione corrispondente a wFormatTag o non riuscito.

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.

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

Vedi anche

Funzioni di compressione audio

Gestione compressione audio

Share via