Condividi tramite


funzione acmFormatSuggest (msacm.h)

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